Payjn(IDN) - Interface doc
  1. Callback Notification
Payjn(IDN) - Interface doc
  • Integration Guide
  • Signature Rules
  • Attachment Code Table
  • Collection
    • Initiate Collection (API)
      POST
    • Initiate Collection (H5 Cashier)
      POST
    • Query Collection Order
      POST
    • Query Available Payment Methods
      POST
  • Payout
    • Initiate Payout
      POST
    • Query Payout Order
      POST
  • Account
    • Query account balance
      POST
  • Callback Notification
    • Collection callback notification
    • Payout callback notification
  1. Callback Notification

Payout callback notification

Request Method: POST
Request Data Format: JSON
Notification Mechanism:
After receiving a notification from Payjn, please return SUCCESS. Otherwise, Payjn will retry the notification up to 8 times. The notification intervals are: 1s, 5s, 10s, 30s, 60s, 300s, 900s, and 1800s.
Header:
VariableTypeRequired/OptionalDescription
Content-TypeStringRequiredFixed value: application/json;charset=utf-8
signStringRequiredSignature generated based on the response body from Payjn; use Payjn's public key to verify
Body:
VariableTypeDescription
merchantCodeStringMerchant code
platformOrderIdStringPlatform order number
merchantOrderIdStringMerchant order number
amountStringOrder amount, decimals are not supported
statusStringOrder status. SUCCESS means successful. For other statuses, see "Status Code List"
bankCodeString(10)Bank code
descStringResult description
createTimeStringCreation time, format: yyyy-MM-dd HH:mm:ss
successTimeStringPayment success time, format: yyyy-MM-dd HH:mm:ss
Example
(With signature)

Status Code List#

Status CodeDescription
SUCCESSPayment successful
FAILUREPayment failed
PROCESSINGProcessing
CANCELLEDOrder cancelled
Modified at 2025-06-30 06:31:27
Previous
Collection callback notification