Overview
Bulk payment is a service that enables your system to submit multiple payments at once. Just like single payment service, bulk payment supports all channels.
Channel | Description |
---|---|
ANB | anb to anb |
SWIFT | International payments through SWIFT network |
SARIE | Local payments through SARIE RTGS network |
IPS |
Instant local transfer via the new SARIE network (STL IBAN only) |
Prerequisites
To use the Bulk Payment service, you need to do the following:
- Register/Login to the anb Developer Portal.
- Create an app.
- You should now have a client id and secret associated with your app.
- Get an access token from our auth service using your client id and secret.
Bulk File Specification
Bulk payments will be submitted via a CSV (comma separated values) file. The structure of the file follows the single payment service specification(TODO). The first row of the file should specify the header of each individual payment.
sequenceNumber,valueDate,currency,amount,orderingParty,orderingPartyAddress1,orderingPartyAddress2,orderingPartyAddress3,debitAccount,destinationBankBIC,channel,creditAccount,beneficiaryName,beneficiaryAddress1,beneficiaryAddress2,narrative,transactionComment,purposeOfTransfer
74180,201102,SAR,1000,Fintech A,Street1,JEDDAH,Saudi Arabia,0108057386290014,ARNBSARI,ANB,0108057386290038,Ahmad Abdullah,KSA,RIYADH,,,38
74180,201102,SAR,1000,Fintech A,Street1,JEDDAH,Saudi Arabia,0108057386290014,ARNBSARI,ANB,0108057386290038,Ahmad Abdullah,KSA,RIYADH,,,38
Once the file gets submitted, the service will assure the validity of the file format and its structure. In case of any issue in the structure or the format, the file will be rejected immediately. If the file format is valid, the file will be accepted and prepared to be processed, and you will receive a unique UUID to be used for any further inquiries. Then, each payment will be validated against a couple of static validation to assure its readiness to be processed.
Bulk Payment Summary Service
You may use this service to get a summary of the submitted file. The service will return the number of valid and invalid payments.
You may use "Single Payment" inquiry service to inquire about the individual payments extracted from the bulk file. Also, the events emitted during single payment processing will also be emitted for each payment submitted in the bulk file.
Invalid Payments Service
You may use this service to inquire about invalid payments submitted in the bulk file. The service will return all invalid payments and indicate their row number and the reason of failure.
Valid Payments Service
You may use this service to inquire about valid payments submitted in the bulk file. Just like single payment structure, the service will return all valid payments along with their unique UUID and other details.
Local Bank BICs
BIC Code | Bank Name | Arabic Name | Clearing Code |
---|---|---|---|
SAMASARI | Saudi Central Bank | البنك المركزي السعودي | 1 |
INMASARI | Al-Inma Bank | بنك الإنماء | 5 |
INMASARI | AL INMA BANK | بنك الإنماء | 05 |
ARNBSARI | ARAB NATIONAL BANK | البنك العربي الوطني | 30 |
RJHISARI | AL RAJHI BANK | مصرف الراجحي | 80 |
BJAZSAJE | BANK AL-JAZIRA | بنك الجزيرة | 60 |
BMUSSARI | BANKMUSCAT | بنك مسقط | 76 |
EBILSARI | EMIRATES BANK INTERNATIONAL PJSC | بنك الإمارات الدولي | 95 |
FABMSARI | FIRST ABU DHABI BANK | بنك أبوظبي الأول | 73 |
CHASSARI | JPMORGAN CHASE BANK, N.A. RIYADH | بنك تشيز | 86 |
BNPASARI | BNP PARIBAS SAUDI ARABIA | بي ان بي ارابيا | 85 |
GULFSARI | GULF INTERNATIONAL BANK B.S.C., RIYADH | بنك الخليج الدولي | 90 |
ALBISARI | BANK AL BILAD | بنك البلاد | 15 |
NBOBSARI | NATIONAL BANK OF BAHRAIN | بنك البحرين الوطني | 71 |
NBOKSAJE | NATIONAL BANK OF KUWAIT | بنك الكويت الوطني | 75 |
NCBKSAJE | SAUDI NATIONAL BANK | البنك الأهلي السعودي | 10 |
RIBLSARI | RIYAD BANK | بنك الرياض | 20 |
SABBSARI | SAUDI BRITISH BANK | البنك السعودي البريطاني | 45 |
SAMASARI | SAUDI ARABIAN MONETARY AGENCY | البنك المركزي السعودي | 01 |
SIBCSARI | SAUDI INVESTMENT BANK | البنك السعودي للإستثمار | 65 |
STCJSARI | STC Bank | بنك اس تي سي | 78 |
DBAKSARI | D360 Bank | دال ثلاثمائة وستون | 36 |
SCBLSAR2 | Standard chartered bank | بنك ستاندر شارتر | 91 |
QNBASARI | Qatar National Bank | بنك قطر الوطني | 72 |
NBIQSARI | National Bank of Iraq | بنك العراق الوطني | 79 |
DEUTSARI | Deutsche Bank | بنك دويتشه | 81 |
TCZBSARI | T.C.ZIRAAT BANKASI A.S. | بنك زراعات | 84 |
BOTKSARI | MUFG Bank | بنك إم يو أف جي | 88 |
CRESSARY | Credit Suisse AG | كريدي سويس | 89 |
VIIOSARI | VISION BANK | بنك فيجن | 93 |
BSHRSARI | Sohar International Bank | بنك صحار الدولي | 92 |