API Reference

Create Seamless Transaction

This API is used to create transaction (directly with payment instrument details) which will provide seamless experience to user. It is like create transaction except for this API merchant must collect the applicable instrument details (e.g. card details) and same must be provided in the request. If successful, redirect URL will be provided in the response to complete the instrument authentication flow.

StepActorAction
1Merchant ServerCreate SeamlessTransaction Request and post it to Emirates NBD pay.
2Emirates NBD GatewayEmirates NBD Pay responds with an ACS URL to the merchant.
3Merchant ServerRedirect the customer to the provided ACS URL.
4Merchant ServerCustomer completes 3DS authentication and is redirected to the Emirates NBD Pay gateway.
5ACSDepending on whether the issuer ACS treats the transaction as challenge or frictionless, customer completes 3DS authentication and is redirected to Emirates NBD Pay.
6Emirates NBD Pay GatewayEmirates NBD Pay gateway completes authorization (Auth/Purchase) and redirects the customer to the merchant’s URL specified in app.redirecturl.
7Merchant ServerIf the webhook URL (app.webhook) was included in Step 1, Emirates NBD Pay sends a server-to-server notification for subscribed events.

HTTP Status and Response Status Matrix

HTTP
Status
Response StatusResponse Message
200CREATEDSuccess
400TRANSACTION_EXPIREDTransaction has expired,
create a new transaction.
400VALIDATION_ERRORWhen validation fails for request body,
field specific validation
errors will be returned.
400ERROR_FROM_PGThis will be populated by PG.
400INTERNAL_PROCESSING_ERRORGateway account not found.
500ERROR_FROM_PGThis will be populated by PG.
500INTERNAL_PROCESSING_ERRORSomething went wrong at our end,
try again after sometime
502ERROR_CONNECTING_PGGateway connectivity unavailable
503ERROR_CONNECTING_PGGateway connectivity unavailable
Language
Credentials
Bearer
Click Try It! to start a request and see the response here!