Brick API Documentation
Brick

การโทรกลับ QR Code - ไดนามิก QR Code

ใช้การโทรกลับนี้เป็นการแจ้งเตือนการชำระเงินหลักแบบเรียลไทม์สำหรับ Dynamic QR Code ระบบของคุณควรจับคู่การโทรกลับไปยังธุรกรรมเดิม อัปเดตอย่างต่อเนื่อง จากนั้นอัปเดตคำสั่งซื้อหรือยอดคงเหลือของลูกค้า

การจัดการการโทรกลับ

  • จับคู่การโทรกลับโดยใช้ referenceId และ Brick QR Code id
  • ถือว่าการโทรกลับเป็น idempotent เนื่องจากการลองใหม่อาจเกิดขึ้นได้
  • จัดเก็บ paidAt, amount, feeAmount และข้อมูลผู้ขายเพื่อการกระทบยอด
  • ส่งคืน HTTP 200 หลังจากที่ระบบของคุณยอมรับการติดต่อกลับแล้วเท่านั้น URL การทดสอบแดชบอร์ด / บันทึกและการทดสอบยังต้องใช้ JSON ACK พร้อมด้วยการทดสอบ Brick referenceId ที่แน่นอน
  • หากเปิดใช้งาน customerInformation ให้จัดเก็บรายละเอียดของผู้ซื้อและผู้ออกสำหรับบันทึกธุรกรรมที่เกี่ยวข้องเท่านั้น

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: หากต้องการซื้อ customerInformation โปรดดู QR Code Overview docs หรือติดต่อทีมขายของเรา

Last modified on