Frequently Asked Questions

If the POST operation of Partner Beneficiary Management is retried, there is a chance that a duplicate beneficiary may be created at the backend. However, the partner application can use any one of the beneficiary created to initiate a transaction.

The API should be invoked only before the daily cutoff time. Any transfers requests initiated by the customer on the partner App/ Web application after the cut-off time must be held at the client's side and posted at BOD (Beginning Of Day) the next business day.

For currency-wise cutoff time applicable for all fund transfers, see cutoff time.

Applicable BOD time the next business day is 08:00 AM UAE time. 

The transaction will fail and the API will return an error response with 20124 response code.

There are daily transaction limits applicable for the API which needs to be enforced by the client on their App/ Web application. For information on applicable limits, see daily transaction limits.

Only within UAE AED payments are processed straight through. All other transactions would be processed after verification by RAKBank operations teams.

In case of failures or reversals, the amount would be credited to the customer’s account and credit notification would be sent to the partner through the Partner Notifications: Account Transactions API. The transaction amount may change based on the forex rate in the system at the time of failure or reversal processing.

Yes, you may retry upto 3 times with an interval of 60 seconds between every retry. Please ensure to pass the same transaction_id in the path for retry requests.

Yes, you may retry upto 3 times with an interval of 60 seconds between every retry. Please ensure to pass the same transaction_id in the path for retry requests.

A plan is collection of API resources or subsets of resources from one or more API. A plan can contain a mixture of HTTP GET, PUT, POST, and DELETE verbs from different APIs or it can contain all the GET verbs from various APIs. A plan can have a common rate limit for all the resources or each resource can have a different rate limit. Rate limits specify how many requests an application is allowed to make during a specified time interval.

Use this Developer Portal to browse the different plans that are available to you and select a plan that is most suitable for your requirements. Some plans have restricted access that you must request access to use. When you submit your request, the organization is notified, the API administrator assesses your request and they might contact you for more details. Other plans are available to use straight away.

It is possible to test an API from this Developer Portal.

When looking at the details of an API you will see a table of the operations contained in the API. This will show what method they are (GET, POST, PUT, DELETE, PATCH, HEAD or OPTIONS) and what path the Resource uses.

If you click on the Resource you will see more information about it, what parameters it might take, what it returns, what possible return codes it might use and what they mean.

There is also a 'Try' button which enables you to try the Resource out direct from the Developer Portal.

If the API requires a client ID or a client secret for identification then you can specify these at the top of the 'Try' section.

Your application client secret is stored encrypted so we cannot retrieve the unencrypted version to tell you the value if you forget it.

You can reset it, which will update the stored value and return the new value to you.

To do that click 'Apps' in the main menu, click on the application in question and then you can click the 'Reset' link in the 'Client Secret' section.

Your new secret will be displayed at the top of the page.

The numbers of requests, for different APIs, that your application has made are shown on your application page.

Click 'Apps' in the main menu and then click on your application. Under 'Subscribed Plans' you will see all plans your application is subscribed to. 

For each API contained in that plan you can see the usage compared to the rate limit of the plan.

When you add an application you are provided with a client ID and client secret for the application. You must supply the client ID when you call an API that requires you to identify your application by using a client ID, or a client ID and client secret.

To register an application click on Apps in the main menu and then click on the 'Register an application' link. Once you have provided an application name, description, etc you will be shown your application client ID and client secret.

Make a note of your client secret because it is only displayed once. You must supply the client secret when you call an API that requires you to identify your application by using a Client ID and Client secret.