API Reference

Create Presentation

post
https://example.com/tnc/checkout/apis/v1/presentations

Allows submission of mandate-based debit requests for transactions using existing customer mandates.

Transaction Idempotency

If appUtr is present in the API request, then the Presentation transaction will be made idempotent. If another Presentation transaction is requested with the duplicate appUtr then the API will reject the presentation transaction.

HTTP Status and Response Status Matrix

HTTP
Status		Response StatusResponse Message
200CREATEDSuccess
400VALIDATION_ERRORRequest body validation failed.
400REJECTEDApp UTR provided is already used.
400ERROR_FROM_PGThis will be populated by PG.
500INTERNAL_PROCESSING_ERRORGateway account not found.
500ERROR_CONNECTING_PGGateway connectivity unavailable.
503ERROR_CONNECTING_PGGateway connectivity unavailable.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 250
^[A-Za-z0-9#_,/().&:\\-]+$

Description of the presentation.

string
required
length ≤ 45

Unique subscription reference (UTR) number received in Create Subscription API.

date-time
required
yyyy-MM-dd HH:mm:ss

Due date for the Presentation.

string
required
length ≤ 20
^[0-9]+

Amount to be charged for each billing cycle. The amount is always considered in the smallest currency sub-unit i.e. to do transaction of 100 USD, provide 10000 as value. In the case of three decimal currencies, such as KWD, BHD and OMR, pass the value as 100000.

app
object
required
events
array of strings

Note of the transaction Similar to user defined fields(udfs).

events
Headers
string
string
Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?