Brick API Documentation
Brick

บัญชีเสมือนโทรกลับ

Brick ส่งการโทรกลับนี้ไปยัง URL ที่คุณกำหนดค่าไว้เมื่อสถานะการชำระเงินของบัญชีเสมือนเปลี่ยนแปลง

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

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

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

ฟิลด์สำคัญ

สนามคำอธิบาย
idตัวระบุการชำระเงิน Brick VA
referenceIdธุรกรรมหรือการอ้างอิงคำสั่งซื้อของคุณ
amountจำนวนเงินที่ชำระ
feeAmountจำนวนค่าธรรมเนียมที่ใช้กับการชำระเงิน
statusสถานะการชำระเงิน VA ล่าสุด
paymentMethod.instructionsรายละเอียดบัญชีธนาคารและ VA ที่ผู้ชำระเงินใช้

ตัวอย่างการโทรกลับสำหรับการอัปเดตสถานะการชำระเงิน VA:

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

เปิดเวอร์จิเนีย

JSONCode
{ "data": { "id": "OP_a586fb49972e43ac9d92dc5199d361fc", "type": "virtual_account", "referenceId": "ref1234", "amount": "10000", "feeAmount": "155", "status": "completed", "createdAt": "2026-06-30T16:11:06.000+07:00", "paymentId": "PAY_d2a60413161158d4ea7334957012bec1", "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name", "metadata": { "orderId": "ORD-123", "customerId": "CUS-999" }, "paymentMethod": { "paymentId": "PAY_d2a60413161158d4ea7334957012bec1", "type": "virtual_bank_account", "instructions": { "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name" } }, "attributes": { "referenceId": "ref1234", "amount": "10000", "feeAmount": "155", "status": "completed", "createdAt": "2026-06-30T16:11:06.000+07:00", "paymentMethod": { "paymentId": "PAY_d2a60413161158d4ea7334957012bec1", "type": "virtual_bank_account", "instructions": { "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name" } }, "metadata": { "orderId": "ORD-123", "customerId": "CUS-999" } } } }

ปิดเวอร์จิเนีย

JSONCode
{ "data": { "id": "CL_a30baa40a98d4c95aca2226cf1d1ef8e", "type": "virtual_account", "referenceId": "ref1234", "description": "Test Initial VA Close", "amount": "10000.0", "feeAmount": "155", "status": "completed", "createdAt": "2026-06-30T16:11:30.000+07:00", "expiredAt": "2026-06-30T17:12:29.000+07:00", "paymentId": "PAY_a051cbf3abed1b1ff6c9d45167fed1d7", "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name", "metadata": { "orderId": "ORD-123", "customerId": "CUS-999" }, "paymentMethod": { "paymentId": "PAY_a051cbf3abed1b1ff6c9d45167fed1d7", "type": "virtual_bank_account", "instructions": { "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name" } }, "attributes": { "referenceId": "ref1234", "description": "Test Initial VA Close", "amount": "10000.0", "feeAmount": "155", "status": "completed", "createdAt": "2026-06-30T16:11:30.000+07:00", "expiredAt": "2026-06-30T17:12:29.000+07:00", "paymentMethod": { "paymentId": "PAY_a051cbf3abed1b1ff6c9d45167fed1d7", "type": "virtual_bank_account", "instructions": { "bankShortCode": "bank_name", "accountNo": "16047686796", "displayName": "customer bank holder name" } }, "metadata": { "orderId": "ORD-123", "customerId": "CUS-999" } } } }
Last modified on