בתשלום מרובה (Bulk) דרך POST /v2/pay/open-banking-init, השדה bulkPaymentInformation.paymentInformationId לא מתנהג אותו דבר בכל הבנקים. ערך שעובד בבנק אחד יכול להחזיר שגיאה בבנק אחר. המבנה הכללי של תשלום מרובה מתואר בתשלום מרובה (Bulk Payment) דרך ה-API.
paymentInformationId לפי בנק
לאומי
אל תשלחו את השדה. כשהוא נשלח, הבנק מחזיר 500 עם FORMAT_ERROR בלי הסבר נוסף. השמיטו את paymentInformationId מהבקשה ללאומי. אנחנו מתקנים את זה ונעדכן כאן.
דיסקונט ומרכנתיל
כאן השדה הוא סוג האצווה, לא מזהה חופשי. ערכים מותרים:
salaries: תשלום משכורותsuppliers: תשלום לספקים
אם לא שלחתם ערך, נשלח suppliers.
קבוצת הבינלאומי
הבינלאומי, אוצר החייל, פאג״י, מסד ו-U Bank. כאן השדה חובה אצל הבנק. אם לא שלחתם אותו, אנחנו ממלאים אותו בשבילכם במזהה התשלום (externalId או paymentId). אפשר גם לשלוח ערך משלכם, עד 35 תווים.
שאר הבנקים
הערך עובר לבנק כמו ששלחתם אותו.
תאריך ביצוע בהפועלים
בבנק הפועלים שלחו bulkPaymentInformation.requestedExecutionDate עם יום עסקים עתידי. בלי השדה, או עם התאריך של היום, המשלם מגיע למסך הבנק והבנק דוחה את התשלום עם הודעה שתאריך ההעברה לא יכול להיות מוקדם מהתאריך הנוכחי. אנחנו מתקנים את זה כך שברירת המחדל תהיה יום העסקים הבא, ונעדכן כאן.
תשלום מחשבון עסקי
ב-
POST /v2/pay/open-banking-initהשדהpsuIdTypeלא משפיע. גם אם תשלחו בו ערך עסקי, הוא לא נקרא.מה שקובע שהתשלום עסקי הוא שליחת
psuCorporateId(מספר החברה). בלי השדה הזה התשלום נשלח כתשלום של אדם פרטי.בדיסקונט ובמרכנתיל שלחו גם
psuCorporateIdType: "Company".תשלום מחשבון פרטי נשלח עם
psuIdבלבד, בליpsuCorporateIdובליpsuCorporateIdType. תעודת זהות פרטית ב-psuCorporateIdהופכת את התשלום לעסקי, והבנק דוחה אותו.
ערכי psuIdTypes שמופיעים ב-GET /v2/providers מתארים את חיבור החשבון (הסכמה לקריאת מידע), לא את התשלום. אל תסיקו מהם מה לשלוח בבקשת תשלום.
איפה בודקים
בדקו את האינטגרציה מול ה-sandbox של Open Finance. סביבות ה-sandbox של הבנקים עצמם (הספקים שהמזהה שלהם מסתיים ב--sandbox) לא עובדות כראוי, ושגיאה שמגיעה מהן לא מעידה על בעיה בבקשה שלכם.
איך מדווחים על תשלום שנכשל
כתבו לנו עם ה-paymentId, הבנק, השעה המשוערת וקוד השגיאה. בלי מספרי חשבון ובלי תעודת זהות או מספר חברה.
שאלות נפוצות
קיבלתי 500 FORMAT_ERROR בלי טקסט בתשלום מרובה בלאומי. מה לבדוק?
קודם כל אם שלחתם paymentInformationId. בלאומי משמיטים אותו.
מה לשים ב-paymentInformationId בדיסקונט?
salaries או suppliers. בלי ערך נשלח suppliers.
בהפועלים המשלם הגיע למסך הבנק והתשלום נדחה בגלל התאריך. למה?
בהפועלים צריך requestedExecutionDate ביום עסקים עתידי. בלי השדה או עם התאריך של היום, הבנק דוחה.
שלחתי psuIdType עסקי והתשלום עדיין נשלח כפרטי. למה?
כי בייזום תשלום psuIdType לא נקרא. שלחו psuCorporateId, ובדיסקונט ובמרכנתיל גם psuCorporateIdType: "Company".
תשלום מחשבון פרטי נדחה בבנק. מה לבדוק?
שלא שלחתם psuCorporateId. בתשלום מחשבון פרטי שולחים psuId בלבד.
קיבלתי שגיאה מספק sandbox של בנק. מה עושים?
עברו ל-sandbox של Open Finance. סביבות ה-sandbox של הבנקים לא עובדות כראוי, אז אין טעם לנסות לתקן מולן.