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

Collection 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:
VariableTypeRequiredDescription
Content-TypeStringYesFixed: application/json;charset=utf-8
signStringYesSignature generated based on the response body from Payjn; use Payjn's public key to verify the received signature
Body:
VariableTypeDescription
statusStringOrder status. SUCCESS means successful. For other statuses, see "Status Code List"
merchantCodeString(6)Unique merchant identifier provided by Payjn
merchantOrderIdString(50)Merchant's internal order number, up to 50 characters, can include letters, must be unique
platformOrderIdString(32)Payjn order number
paymentMethodCodeString(10)Payment method code
countryCodeStringCountry code (IDN for Indonesia)
amountString(12,2)Amount specified when creating the order, in the local currency
paidAmountString(12,2)Actual amount received, in the local currency, two decimal places. May differ from order amount. Refer to amount for order amount.
createTimeStringCreation time, format: yyyy-MM-dd HH:mm:ss
successTimeStringPayment success time, format: yyyy-MM-dd HH:mm:ss
Example
Asynchronous Callback Notification

Status Code List#

Status CodeDescription
SUCCESSPayment successful
FAILUREPayment failed
PROCESSINGProcessing
CANCELLEDOrder cancelled
Modified at 2025-06-30 06:31:17
Previous
Query account balance
Next
Payout callback notification