Payment Validation

post

https://{merchant_server}/api/validation

Webhook that allows the merchant to approve or reject a transaction after payment details are submitted in Cashier or Virtual Terminal before processing.

Note: You must pass the validation_url as part of the Cashier or Virtual Terminal Initiate Payment payload, and Praxis will send the validation request to this URL.

Body Params

merchant_id

string

required

length ≤ 50

Merchant API client account identifier.

application_key

string

required

length ≤ 32

Identifier of your application (website).

version

string

required

length ≤ 3

API version.

timestamp

integer

required

Request time (unix timestamp, seconds).

customer

object

required

The customer representation object provided during the response.

session

object

required

Session Object provided during the response.

transaction_attempt

object

required

Transaction attempt object

Headers

gt-authentication

string

required

Authentication HTTP header of an incoming webhook notification request from Praxis.
Verify the signature with the below attributes from the webhook notification request.

merchant_id
application_key
timestamp
customer.customer_token
session.order_id
transaction_attempt.currency
transaction_attempt.amount
transaction_attempt.conversion_rate
transaction_attempt.attempted_currency
transaction_attempt.attempted_amount

Response

200OK - Successful response