Callback

After every successful transaction, a callback will be sent to the URL you provided through the callback_url parameter. Instead of plain text, Payright uses an encoded JWT message for these callbacks. You'll need to decode the message using a hash key to access its content. You may get your hash key from

Account > API Keys > View API Key > Hash Key

Sample of JWT encoded callback response

{"data": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpbnZvaWNlX25vIjoiRlBYMTczNDUyMTU3OGNiN09odE1KIiwiaW52b2ljZV9yZWYiOiJEUEwxMTI0NTk5TFgiLCJpbnZvaWNlX3N0YXR1cyI6IlNVQ0NFU1MiLCJhbW91bnQiOiIyNDAuMDAiLCJmcHhfYnV5ZXJfbmFtZSI6bnVsbCwidHJhbnNhY3Rpb25fcmVzcG9uc2VfdGltZSI6IjE4IERlY2VtYmVyIDI0IDA3OjMzOjExIFBNIiwiaW52b2ljZV90eXBlIjoiTk9STUFMX0NPTExFQ1RJT04iLCJmcHhfdHJhbnNhY3Rpb25faWQiOm51bGwsImZweF9kZWJpdF9zdGF0dXMiOiIiLCJmcHhfY3JlZGl0X2F1dGhfY29kZSI6bnVsbCwiZnB4X3R4bl9jdXJyZW5jeSI6bnVsbCwiZnB4X2J1eWVyX2JhbmsiOm51bGx9._j5hrFHQXxmCtqdDAFAv7rdFCnSGHBSgHuMaeUr3YrA", "response_code": 2100}

Sample callback response after JWT decode

{
  "invoice_no": "FPX1734521578cb7OhtMJ",
  "invoice_ref": "DPL1124599LX",
  "invoice_status": "SUCCESS",
  "amount": "240.00",
  "fpx_buyer_name": Khairul Mukmin,
  "transaction_response_time": "18 December 24 07:33:11 PM",
  "invoice_type": "NORMAL_COLLECTION",
  "fpx_transaction_id": 1726547891123,
  "fpx_debit_status": "00",
  "fpx_credit_auth_code": 00,
  "fpx_txn_currency": MYR,
  "fpx_buyer_bank": "Bank Islam Malaysia"
}