Brick API Documentation
Brick

Panggilan Balik QR Code - QR Code Dinamis

Gunakan panggilan balik ini sebagai pemberitahuan pembayaran real-time utama untuk Dynamic QR Code. Sistem Anda harus mencocokkan panggilan balik dengan transaksi asli, terus memperbarui, lalu memperbarui pesanan atau saldo pelanggan.

Penanganan Panggilan Balik

  • Cocokkan callback menggunakan referenceId dan Brick QR Code id.
  • Perlakukan panggilan balik sebagai idempoten karena percobaan ulang dapat terjadi.
  • Simpan paidAt, amount, feeAmount, dan informasi pedagang untuk rekonsiliasi.
  • Kembalikan HTTP 200 hanya setelah sistem Anda menerima panggilan balik. URL Pengujian Dasbor/Simpan & Uji juga memerlukan JSON ACK dengan pengujian Brick yang sama persis dengan referenceId.
  • Jika customerInformation diaktifkan, simpan detail pembeli dan penerbit hanya untuk catatan transaksi yang relevan.

This is a sample of the status update we send to your callback URL:

JSONCode
{ "data": { "id": "QR_898df65b2e7a451fa0b7d38b7dbed24b", "type": "qris", "referenceId": "ref1234", "amount": 1000, "feeAmount": 8, "status": "COMPLETED", "createdAt": "2026-06-30T16:04:24.581+07:00", "paidAt": "2026-06-30T16:05:10.590+07:00", "qrisType": "DYNAMIC", "merchant": null, "merchantNmid": null, "customerInformation": { "customerName": "customer name", "issuerName": "payer bank" }, "metadata": { "orderId": "ORD-123", "customerId": "CUS-999" } } }

This is a sample of the status update we send to your callback URL if customerInformation is enabled:

JSONCode
{ "data": { "id": "QR_0a50018350f34cd4901c97e22cb1cfde", "referenceId": "1710323916255", "amount": 11000, "feeAmount": 77, "status": "PAID", "createdAt": "2024-03-13T16:58:37.000+07:00", "paidAt": "2024-03-13T23:58:58.000+07:00", "qrisType": "DYNAMIC", "merchant": null, "merchantNmid": null, "customerInformation": { "customerName": "Customer QR Code", "issuerName": "issuerName" } } }

Note: Untuk mendapatkan customerInformation, lihat QR Code Overview docs atau hubungi tim Penjualan kami.

Last modified on