Push Notification

Definitions

Merchant receives the payment information from bank through back-end to back-end. This prevents risk of not receiving the information due to customer’s device, web browser, and internet connection, as well the bank also receives the payment status.

Bank requirements

In order to get the service, the merchant must register its API url to receive notification in the bank.

API must support only the POST method. Other methods as GET, PUT ,DELETE must be disabled.

SSL must be set

Information to be sent by the bank


Protocol	HTTP
Method	POST
Content-Type	application/json

Example of successful transaction

{
  "amount": "1",
  "bank": "Голомт банк",
  "errorDesc": "Амжилттай",
  "checksum": "8e2538fac797d6828.....................3c6863f60aac",
  "errorCode": "000",
  "cardHolder": "9496250",
  "transactionId": "test000001",
  "cardNumber": "949625******0003",
  "token": "9ffd1bb0544990........b0feaae5f8ee3d824e"
}

Example of unsuccessful transaction

{
  "amount": "1",
  "bank": "Голомт банк",
  "errorDesc": "Картын хугацаа дууссан",
  "checksum": "8e2538fac797d6828ca93c34a4487c54e75803a18978d425dfec3c6863f60aac",
  "errorCode": "300",
  "cardHolder": "9496250",
  "transactionId": "test000001",
  "cardNumber": "949625******0003"
}

Параметрүүд

Parameter	Type	Definition
amount	String	Amount withdrawn from the card
bank	String	Card issuer bank
errorDesc	String	Transaction status definition
checksum	String	`checksum` = `transactionId` + `errorCode` + `amount` + `token` When token is not created `token` token field is not included
errorCode	String	See transaction status code here
cardHolder	String	Card holder
transactionId	String	Merchant's transaction number
cardNumber	String	Transaction card number
token	String	Token number to present the card

token is a value to represent the card information provided to the merchant only for successful transactions. Here, the pre-token setting or genToken parameter had to be set to “Y” on the invoice request to the bank.

API

Checksum

API