Brick API Documentation
Brick

QR Code การโทรกลับแบบไดนามิก (SNAP)

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

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

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

ตัวอย่างเพย์โหลดการโทรกลับ

นี่คือตัวอย่างการอัปเดตสถานะที่เราส่งไปยัง URL โทรกลับของคุณ:

JSONCode
{ "originalReferenceNo":"", "originalPartnerReferenceNo":"", "transactionStatusDesc":"PAID", "amount":{ "value":"10000.00", "currency":"IDR" }, "latestTransactionStatus":"00", "additionalInfo":{ "issuerName":"GOPAY", "paymentDate":"2024-11-15T14:28:41+07:00", "buyerReff":"", "terminalId":"A01", "username":"customer-name", "rrn":"123456789012" } }
JSONCode
{ "originalReferenceNo":"", "originalPartnerReferenceNo":"", "transactionStatusDesc":"EXPIRED", "amount":{ "value":"10000.00", "currency":"IDR" }, "latestTransactionStatus":"06" }
Last modified on