Overview
The Bulk SADAD and MOI Payment Services offered by Arab National Bank (ANB) enable corporate clients to efficiently manage large-scale payments. Clients can upload CSV files for bulk payments, process payments one by one through the SADAD and MOI systems, and track payment statuses using the API. This service ensures a seamless and reliable payment experience with features such as real-time notifications, error handling, and retry mechanisms for failed transactions.
Why Bulk SADAD and MOI Services?
Efficiency: Automate bulk payments with a single CSV file.
Reliability: Built-in error handling ensures smooth processing.
Ease of Use: Simple file upload and instant transaction tracking.
Prerequisites
To use this service, you must:
- ANB Connect Account: A registered and active account on the ANB Connect platform.
- CSV File Format: Files must be in CSV format; incorrect formats will result in rejection.
- API Credentials: API keys and client credentials must be obtained for secure access.
- Customer Sequence Reference Number: Mandatory for transaction tracking.
- Group ID: Generated upon file submission for tracking and inquiry purposes.
To create a new application
Sign up on the ANB Connect API Portal and create a new application for the Bulk SADAD/MOI Payment Services.
- Obtain API Credentials: Receive your API credentials (API Key, Client ID, Secret Key) after approval. Keep these credentials secure.
- Upload CSV Files: Prepare and upload the bulk payment file in CSV format using the provided URL. Ensure that each file complies with the format requirements to avoid rejection.
- Test Your Application: Utilize the ANB Connect sandbox environment for testing. Validate the payment processing before moving to production.
- Go Live: After successful testing, request production access and begin real-time bulk payment processing.
How to Integrate with ANB Connect
- CSV File Submission: Upload CSV files to the API endpoint for bulk SADAD or MOI payments.
- Transaction Inquiry: Use the inquiry service to track payment statuses in real-time. Responses are provided in arrays.
- Notification Service: Configure notifications for events like sadad.received or moi.completed to receive real-time transaction updates.
- Error Handling: In case of errors, the system retries up to three times. Failed records are reported for correction and resubmission.
Response Codes
Status Code | Description |
---|---|
E650033 | File cannot be parsed |
E620092 | Account has Insufficient Funds |
E620083 | Sadad Timeout |
E620093 | Account is Not Valid |
E6500058 | SADAD/MOI http exception |
E6500057 | Sadad not enabled for the account |