Brick API Documentation
Brick

การโทรกลับการชำระเงิน BI-FAST

การเรียกกลับการชำระเงินของ BI-FAST จะแจ้งจุดสิ้นสุดที่กำหนดค่าไว้ของคุณเมื่อสถานะการจ่ายเงินของ BI-FAST เปลี่ยนแปลง ใช้เพย์โหลดการโทรกลับนี้เพื่ออัปเดตบันทึกการจ่ายเงินภายใน ปรับยอดการโอนที่เสร็จสมบูรณ์หรือล้มเหลว และรักษาแดชบอร์ดลูกค้าหรือการดำเนินงานให้สอดคล้องกับสถานะธุรกรรมสุดท้ายของ Brick

JSONCode
{ "data": { "id": "84jt9r94jr4r84r894jr8j4", "type": "disbursement", "attributes": { "referenceId": "ref-disbursement-1", "description": "ref-disbursement-1", "amount": "30000", "status": "completed", "settlementStatus":null, "createdAt": "2023-09-21T13:49:39.752+08:00", "disbursementMethod": { "type": "bank_transfer", "bankAccountNo": "12345678", "bankShortCode": "BCA", "bankAccountHolderName": "BUDI SUSANTO", "bankName" : "Bank Central Asia", "sender": { "name": "BUDI SUSANTO", "identityType": "KTP", "identityNumber": "350104635820003", "countryCode": "ID", "provinceCode": "35", "cityCode": "1226", "jobCode": "89", "address": "JAkarta Sudirman No 4", "placeOfBirth": "BAndung", "dateOfBirth": "2000-04-23" } } } } }
JSONCode
{ "data": { "id": "9cb8ba6c8aa644ff9a433ace9", "type": "disbursement", "attributes": { "referenceId": "sc-MAR-5437", "description": "Good Luck", "amount": "10000", "status": "failed", "settlementStatus": null, "createdAt": "2025-02-12T16:25:11.000+07:00", "errorCode": "5000100", "errorReason": "General Error", "errorDetail": { "code": "general_error", "message": "General Error", "action": "Please try again later or contact support if the issue persists.", "reason": "A general error occurred while processing the request. This may be due to a temporary issue on our end." }, "disbursementMethod": { "type": "bank_transfer", "bankAccountNo": "010800041187", "bankShortCode": "BCA", "bankAccountHolderName": "JOHN CENA", "bankName": "BCA" } } } }

โปรดทราบเมื่อคุณตั้งค่าปลายทางการโทรกลับ:

  • โพสต์ Callback method :
  • แอป Content type :/json
  • ส่งคืน HTTP 200 หลังจากที่ระบบของคุณยอมรับการติดต่อกลับแล้วเท่านั้น URL การทดสอบแดชบอร์ด / บันทึกและการทดสอบยังต้องใช้ JSON ACK พร้อมด้วยการทดสอบ Brick referenceId ที่แน่นอน
  • เพิ่มไวท์ลิสต์ให้กับเซิร์ฟเวอร์ Brick เพื่อการเชื่อมต่อที่ปลอดภัย

พารามิเตอร์การตอบสนอง

พารามิเตอร์ที่สำคัญชนิดข้อมูลคำอธิบาย
รหัสสตริงตัวระบุที่ไม่ซ้ำ
ประเภทสตริงประเภทของธุรกรรม
สถานะสตริงสถานะของการเบิกจ่าย
สร้างขึ้นที่ประทับเวลาเวลาที่สร้างการตอบกลับ
จำนวนจำนวนเต็มจำนวนเงินที่จะจ่าย
รหัสอ้างอิงสตริงรหัสอ้างอิงที่ไม่ซ้ำกันเป็นตัวระบุที่ไม่ซ้ำกัน
คำอธิบายสตริงสตริงที่กำหนดเองแนบกับวัตถุ มักมีประโยชน์ในการแสดงให้ผู้ใช้เห็นว่าธุรกรรมมีไว้เพื่ออะไร ขีดจำกัดความยาวคำอธิบายคือ 255 ตัวอักษร
ประเภทวิธีการชำระเงินสตริงปัจจุบันรองรับการโอนเงินผ่านธนาคารเท่านั้น
เลขที่บัญชีธนาคารสตริงหมายเลขบัญชีของผู้ใช้
ธนาคาร ShortCodeสตริงรหัสย่อสถาบันของผู้ใช้
ชื่อผู้ถือบัญชีธนาคารสตริงชื่อบัญชีที่ต้องการส่งเงินไป
ชื่อธนาคารสตริงชื่อของสถาบัน
สถานะการตั้งถิ่นฐานสตริงสถานะของธุรกรรม
รหัสข้อผิดพลาดสตริงตัวระบุที่ไม่ซ้ำกันซึ่งแสดงถึงข้อผิดพลาดที่เกิดขึ้นระหว่างการทำธุรกรรม ดูวิธีจัดการกับข้อผิดพลาด here
ข้อผิดพลาดเหตุผลสตริงคำอธิบายโดยย่อเกี่ยวกับข้อผิดพลาดที่ทำให้ธุรกรรมล้มเหลว
รายละเอียดข้อผิดพลาดวัตถุ JSONรายละเอียดข้อผิดพลาด รวมถึงข้อมูลเฉพาะเกี่ยวกับสาเหตุและขั้นตอนการแก้ไขที่เป็นไปได้

พารามิเตอร์การตอบสนองเพิ่มเติม:

ผู้ส่ง (วัตถุ JSON)

พารามิเตอร์ที่สำคัญประเภทข้อมูลคำอธิบายข้อจำกัด
ชื่อสตริงชื่อของผู้ใช้ที่ส่งเงิน1. ตัวเลขอัลฟ่า 2. เว้นวรรคได้ 3. สูงสุด 40 ตัวอักษร
ประเภทตัวตนสตริงค่าที่อนุญาตเฉพาะ KTP/SIM/KITAS/NPWPค่าที่อนุญาตเฉพาะ KTP/SIM/KITAS/NPWP
หมายเลขประจำตัวสตริงหมายเลขประจำตัวของผู้ใช้1. ตัวเลขอัลฟ่า 2. ขั้นต่ำ 10 ตัวอักษร 3. สูงสุด 16 ตัวอักษร
รหัสประเทศสตริงรหัสประเทศสองตัวอักษรสำหรับผู้ส่งค่าที่อนุญาต: 2 ตัวพิมพ์ใหญ่
รหัสจังหวัดสตริงรหัสจังหวัดสองตัวอักษรสำหรับผู้ส่งค่าที่อนุญาต: 2 ตัวพิมพ์ใหญ่
รหัสเมืองสตริงรหัสเมืองสี่ตัวอักษรสำหรับผู้ส่งค่าที่อนุญาต: อักขระตัวพิมพ์ใหญ่ 4 ตัว
รหัสงานสตริงรหัสงานสี่ตัวอักษรสำหรับผู้ส่งค่าที่อนุญาต: อักขระตัวพิมพ์ใหญ่ 4 ตัว
ที่อยู่สตริงที่อยู่ของผู้ใช้1. ตัวเลขอัลฟ่า 2. เว้นวรรคได้ 3. สูงสุด 40 ตัวอักษร
สถานที่เกิดสตริงสถานที่เกิดของผู้ใช้1. ตัวเลขอัลฟ่า 2. เว้นวรรคได้ 3. สูงสุด 40 ตัวอักษร
วันเกิดสตริงวันเกิดของผู้ใช้รูปแบบ ปปปป-ดด-วว

errorDetail (วัตถุ JSON)

พารามิเตอร์ที่สำคัญประเภทข้อมูลคำอธิบาย
รหัสสตริงรหัสข้อผิดพลาดที่เครื่องอ่านได้ซึ่งจัดหมวดหมู่ข้อผิดพลาด
ข้อความสตริงข้อความแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้ซึ่งอธิบายปัญหา
การกระทำสตริงการดำเนินการที่แนะนำที่สามารถทำได้เพื่อแก้ไขข้อผิดพลาด
เหตุผลสตริงบริบทเพิ่มเติมที่อธิบายสาเหตุที่เกิดข้อผิดพลาด
Last modified on