- Overview
- APIs Offered
- Applications must get the token using the “Get Token API," which will provide the access token details. This token must be used for the subsequent interactions of RESTful APIs. Tokens will be valid for 180s
- Client ID and relevant information is verified in the system to establish the connection .If it is a batch payment batchcount is compulsory to input .i.e. number of transactions.
- After authentication and validation vendorPayment API enables to proceed for the initiation of batch transactions.
- Client ID and relevant information will be shared with you after the IPs are whitelisted and connection is established between corporate and mashreq. There are certain protocols to be followed to establish the connection.
- Please note these are parameters and should be used as parameters in the request.
This API allows clients to register a customer’s Direct Debit Authorisation (DDA) details into the system securely. This API captures essential banking and customer information required to set up recurring payments via direct debit.
NOTE:
Flow Chart
What operations can be performed?
1. initiateDDARegistration: This service is a POST method and enables corporates to initiate registration for Direct Debit Authorisation and returns the interim status.
Request Headers:
Request Parameters:
Response Parameters:
Status Code Information:
IMPORTANTS NOTES:

Mashreq’s Collection APIs enable corporate clients to efficiently manage and automate the collection of payments from their customers, partners, or subsidiaries. The product supports multiple collection channels like Direct Debit Authorisation (DDA) to streamline receivables, enhance cash flow visibility, and simplify reconciliation.
What are the benefits?
Real-Time Payment Visibility
Provides instant access to payment status, supporting better cash flow and liquidity management.
Automated Processing
Reduces manual effort by enabling scheduled, rule-based collections directly from customer accounts.
Improved Reconciliation
Simplifies reconciliation of payments with online tracking and detailed transaction records.
Reduced Fraud Risk
Direct debit mandates verify customer accounts upfront, lowering the risk of fraudulent transactions.
Operational Efficiency
Minimises errors, reduces manual tracking, and integrates easily with ERP and treasury systems.
Timely Payments
Reduces the likelihood of missed or delayed payments, improving payment efficiency.
Which APIs are offered?
- Direct Debit Authorisation Registration API: This API allows clients to register a customer’s Direct Debit Authorisation (DDA) details into the system securely. This API captures essential banking and customer information required to set up recurring payments via direct debit.
By leveraging Mashreq’s Collection APIs, corporates can achieve faster payment cycles, improved liquidity, and greater operational efficiency by making receivables management seamless, secure, and scalable.