Webhook & Callbacks

QRIS Callback

Webhook ini dikirim ketika ada perubahan status pada transaksi pembayaran QRIS.

Endpoint Setup

Anda perlu menyediakan endpoint di server Anda untuk menerima callback ini:

POST https://your-domain.com/webhook/payment-qr-notification

Headers yang Diterima

Parameter	Tipe	Keterangan
Content-Type	string	application/json
X-TIMESTAMP	datetime	Timestamp saat callback dikirim.
X-SIGNATURE	string	Signature untuk verifikasi.
X-PARTNER-ID	string	Partner ID merchant.

Request Body

{
  "originalReferenceNo": "ORDER-123456",
  "originalPartnerReferenceNo": "REF-2024101610001",
  "latestTransactionStatus": "00",
  "amount": {
    "value": "100000.00",
    "currency": "IDR"
  },
  "additionalInfo": {
    "payerIssuer": "93600014",
    "payerName": "A ZAHIDIN",
    "payerRefId": "9360001410215660225",
    "billNumber": 84756,
    "transactionDate": "2026-03-17T14:35:20+07:00",
    "feeAmount": {
      "value": "0.00",
      "currency": "IDR"
    }
  }
}

Transaction Status Codes

Status Code	Description	Action Required
00	Success	Update order status ke PAID.
01/03	Pending	Wait for next notification.
06	Failed	Update order status ke FAILED.

Response Expected

Anda harus mengembalikan response HTTP 200 dengan body:

{
  "responseCode": "2002600",
  "responseMessage": "Success"
}

Contoh Implementasi

Contoh implementasi lengkap dalam Node.js dan PHP akan segera ditambahkan. Untuk sementara, gunakan dokumentasi ini sebagai referensi untuk mengintegrasikan API ini.