Payment Notification

post

https://{merchant_server}/api/notification

Notification from Banxis where merchant would receive the latest status of the transaction.

Note: You would be sending notification_url as part of Initiate payment payload and Banxis would send the latest status to this mentioned url.

Important Guidelines

Retries: If your API response contains "status": -1 or returns an unrecognized format, the notification will be automatically resent in approximately 5 minutes.

Amount Changes: Transaction and session amounts may change during processing. For more information, refer Understanding Amounts.

Timeouts: To receive additional notifications in the event of a timeout, please contact our support team to enable the "Notifications for delayed processing via Direct API" setting. (The timeout is a configurable value in seconds).

Signature Calculation: Fields with a null value should be skipped when building the signature.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

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).

conversion_rate

double

0 to 9999999999.999998

Conversion rate between currency and processed_currency applied during conversion from amount to processed_amount. Applies to successful transactions. The value is calculated as 1 processed_currency / 1 currency = conversion_rate

customer

object

required

The customer representation object provided during the response.

session

object

required

Session Object provided during the response.

transaction

object

Transaction object provided during the response.

Headers

gt-authentication

string

required

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

merchant_id
application_key
timestamp
customer.customer_token
session.order_id
transaction.tid
transaction.currency
transaction.amount
transaction.conversion_rate
transaction.processed_currency
transaction.processed_amount

Response

200OK - Successful response