Overview

Proxy Lookup introduced by Arab National Bank (ANB) is designed to streamline the verification of account details for corporate clients, ensuring accuracy by validating information such as IBAN, National ID, and Debtor BIC before any transaction is processed, thereby minimizing the risk of payment errors and enhancing financial operations. Clients have the option to use Bulk Proxy Lookup for verifying multiple accounts simultaneously by submitting a CSV file, making it ideal for businesses with high transaction volumes, or Single Proxy Lookup for individual account verifications, which provides a quick and efficient solution with immediate feedback on account validity.

 

Why Proxy Lookup?

  • Receive instant Match/No Match responses.
  • Webhook notifications provide status updates for each request.
  • Review and Resubmit (For Bulk Proxy Lookup).
  • Review failed records, correct them, and resubmit for validation.

 

Prerequisites

To use either Bulk Proxy Lookup or Single Proxy Lookup, clients need the following:

  • B2B Connectivity: Clients must be connected to ANB’s B2B platform to access the Proxy Lookup services.
  • IPS Proxy Registration: Ensure registration via proxy using National ID, IBAN, or Debtor BIC.
  • CSV File Format (For Bulk Proxy Lookup): Bulk requests must be submitted in CSV format.

 

How to use the service

  • Bulk File Submission: Upload CSV files containing multiple account details.
  • Proxies: Verify accounts using National ID, IBAN, and Debtor BIC.
  • Real-Time Response: Receive instant Match/No Match responses for each account.
  • Automated Process: The system automatically processes and logs all requests in the B2B database.
  • Webhook Notifications: Get real-time notifications upon completion of the verification process.

 

API Integration

Integrate ANB’s B2B API for submitting Proxy Lookup requests, whether bulk or single.

 

Upload and Submit

For Bulk Proxy Lookup, prepare a CSV file with account details and upload it through the API.
For Single Proxy Lookup, submit individual account verification requests directly via API.

 

Response Codes

Response codes
HTTP Code Status Code Label Description
200 - OK The request has succeeded.
400 E650054 Duplicate Account Verification An account verification request with the same details has already been submitted.
400 E650055 Account verification validation The account verification request failed due to validation errors in the input data.
404 999993 Not Found The requested resource was not found.
404 E650006 PAYMENT_NOT_FOUND Bulk with a specified ID doesn't exist.
404 E650048 Account verification not found The specified account verification record does not exist.
400 - Validation Failure (IBAN) IBAN must be a string and have at least 24 characters long.
400 - Validation Failure (National ID) National ID must be a string and at least 10 characters long.
400 - Validation Failure (BIC) Destination Bank BIC must be a string and at least 8 characters long.