API Reference

Create Transaction (Pay by Wallets)

This API is used to create transactions with PG where payment is made through wallets like Apple Pay, Samsung Pay, etc. This API is applicable when the preferred mode of payment is Apple Pay or Samsung Pay. No other payment methods are supported. Like Create Transaction API, accepted transaction types are AUTH and PURCHASE. Refer to parameter transactionType in the request body. The encrypted DPAN value must be provided in encryptedPayload parameter for the transaction to be successful.

Transaction Idempotency

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

HTTP Status and Response Status Matrix

HTTP StatusResponse StatusResponse Message
200AUTHORIZED, CAPTUREDSuccess
200AUTHORIZATION_DECLINEDTransaction has been declined
400VALIDATION_ERRORWhen validation fails for request body, field specific validation errors will be returned.
400INVALID_REQUESTNotes provided is not a valid JSON
400ERROR_FROM_PGThis will be populated by processor.
500ERROR_FROM_PGError in Processing Gateway Response
500INTERNAL_PROCESSING_ERRORWhen there is an error/exception at Checkout which is not handled gracefully or un-recoverable. Specific error messages or generic error messages will be returned on a basis of scenario.
500INTERNAL_PROCESSING_ERRORGateway account not found
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!