Articles in this section

POSTBACK API: What is the purpose of Postback API?

  • Updated
Follow

This API is used to supply additional transaction data after transaction processing.

You can find Postback API documentation here.

All the postbacks should be sent to this endpoint:

api/postback

 

You can send several postback statuses on one event. For example, the transaction was successfully processed. And then, after 25 days, you have received fraud alert on it. You decided to make a refund.

In this case, you are sending 3 postbacks:

1. Transaction_status: success
2. Transaction_status: fraud_alert
3. Transaction_status: refunded

Example of transaction statuses:

  • success
  • declined
  • refunded
  • fraud_alert
  • chargeback
  • processing
  • error
  • could be more...

A few explanations for the other postback fields:

  • code – the code that is returned from bank issuer or acquirer with transaction status
  • reason – the message returned from bank issuer or acquirer with transaction status
  • psp code – the code in which you are mapping “code”
  • psp reason – the reason in which you are mapping “reason”

 

Request example when request_id is known

{
  "request_id": 123456,
  "transaction_status": "success",
  "code": "4002",
  "reason": "Insufficient funds",
  "secure3d": "0",
  "avs_result": "U",
  "cvv_result": "M"
}

Request example when only transaction_id is known

{
  "transaction_id": "TR123456",
  "transaction_status": "success",
  "code": "4002",
  "reason": "Insufficient funds",
  "secure3d": "0",
  "avs_result": "U",
  "cvv_result": "M"
}

Response example

{
  "requestId": 123456
}

Related articles