การเบิกจ่ายตามปกติ
ใช้จุดสิ้นสุดการเบิกจ่ายปกติเพื่อสร้างการจ่ายเงินแบบส่งเงินผ่านขั้นตอนการกำหนดเส้นทางปกติเหมือน RTOL ของ Brick ตำแหน่งข้อมูลนี้มีประโยชน์เมื่อปลายทาง จำนวนเงินในการทำธุรกรรม หรือการตั้งค่าราคาสอดคล้องกับเส้นทางปกติ และเมื่อธุรกิจของคุณต้องการให้บัญชีธนาคารเป็นอัตโนมัติหรือการชำระเงิน Ewallet ที่รองรับ ให้จัดเก็บไคลเอ็นต์ referenceId และยืนยันผลลัพธ์สุดท้ายผ่านการตรวจสอบสถานะหรือการโทรกลับการเบิกจ่าย
ขอพารามิเตอร์
| พารามิเตอร์ที่สำคัญ | ประเภทข้อมูล | คำอธิบาย |
|---|---|---|
| โทเค็นการเข้าถึงสาธารณะ | สตริง | โทเค็นการเข้าถึงครั้งเดียวที่สร้างขึ้นโดยใช้โทเค็นการตรวจสอบสิทธิ์ API |
| รหัสอ้างอิง | สตริง | รหัสอ้างอิงที่ไม่ซ้ำกันเป็นตัวระบุที่ไม่ซ้ำกัน |
| จำนวน | จำนวนเต็ม | จำนวนเงินที่จะจ่าย |
| อีเมลผู้รับ | สตริง | อีเมล์ของผู้รับโอน ระบบจะส่งอีเมลและหลักฐานการโอน PDF มาที่อีเมลนี้ |
| คำอธิบาย | สตริง | สตริงที่กำหนดเองแนบกับวัตถุ มักมีประโยชน์ในการแสดงให้ผู้ใช้เห็นว่าธุรกรรมมีไว้เพื่ออะไร ขีดจำกัดความยาวคำอธิบายคือ 255 ตัวอักษร |
| ประเภท | สตริง | ปัจจุบันรองรับการโอนเงินผ่านธนาคารเท่านั้น |
| เลขที่บัญชีธนาคาร | สตริง | หมายเลขบัญชีของผู้ใช้ผู้รับ |
| ธนาคาร ShortCode | สตริง | รหัสย่อของสถาบันของบัญชีธนาคารของผู้ใช้ผู้รับ |
| ชื่อผู้ถือบัญชีธนาคาร | สตริง | ชื่อบัญชีที่ต้องการส่งเงินไป |
การทดสอบในสภาพแวดล้อม Sandbox (โหมด Testing)
เพื่อจำลองสถานะธุรกรรมต่างๆ ให้ใช้อินพุตตัวอย่างด้านล่างเมื่อเรียก Disbursement API ในสภาพแวดล้อม sandbox:
การเบิกจ่ายแบบ Regular
| รหัสย่อธนาคาร | เลขที่บัญชีธนาคาร | ชื่อเจ้าของบัญชีธนาคาร | จำนวนเงิน | สถานะที่คาดหวัง |
|---|---|---|---|---|
| MANDIRI | 112233445 | PROD ONLY | Rp29.999 | Completed |
| BRI | 112233445 | PROD ONLY | Rp10.000 - Rp500.000.000 | Processing |
| MANDIRI | 112233445 | PROD ONLY | Rp39.999 | Failed |
| SINARMAS | 112233445 | PROD ONLY | Rp10.000 - Rp500.000.000 | Failed with error 503 (Bank Under Maintenance) |
หมายเหตุสำคัญสำหรับการทดสอบ Sandbox:
- เลขที่บัญชีธนาคาร: สามารถใช้หมายเลขใดก็ได้ที่มีมากกว่า 8 หลัก
- ชื่อเจ้าของบัญชี: ต้องเป็น "PROD ONLY" ทุกครั้งแบบตรงตัว
- จำนวนเงิน: ต้องอยู่ในช่วง Rp10.000 ถึง Rp500.000.000
- ค่าเหล่านี้ถูก hardcode ในสภาพแวดล้อม sandbox ของเราเพื่อช่วยจำลองสถานะการตอบกลับที่เฉพาะเจาะจง
พารามิเตอร์การตอบสนอง
| พารามิเตอร์ที่สำคัญ | ชนิดข้อมูล | คำอธิบาย |
|---|---|---|
| รหัส | สตริง | ตัวระบุที่ไม่ซ้ำ |
| ประเภท | สตริง | ประเภทของธุรกรรม |
| สถานะ | สตริง | สถานะของการเบิกจ่าย |
| สร้างขึ้นที่ | ประทับเวลา | เวลาที่สร้างการตอบกลับ |
| ความล้มเหลวเหตุผล | สตริง | สาเหตุของการทำธุรกรรมล้มเหลว ฟิลด์นี้จะแสดงเฉพาะเมื่อการทำธุรกรรมล้มเหลว |
| จำนวน | สตริง | จำนวนเงินที่จะจ่าย |
| ค่าธรรมเนียมจำนวนเงิน | สตริง | ค่าธรรมเนียมการทำธุรกรรม |
| รหัสอ้างอิง | สตริง | รหัสอ้างอิงที่ไม่ซ้ำกันเป็นตัวระบุที่ไม่ซ้ำกัน |
| คำอธิบาย | สตริง | สตริงที่กำหนดเองแนบกับวัตถุ มักมีประโยชน์ในการแสดงให้ผู้ใช้เห็นว่าธุรกรรมมีไว้เพื่ออะไร ขีดจำกัดความยาวคำอธิบายคือ 255 ตัวอักษร |
| ประเภทวิธีการชำระเงิน | สตริง | ปัจจุบันรองรับการโอนเงินผ่านธนาคารเท่านั้น |
| เลขที่บัญชีธนาคาร | สตริง | หมายเลขบัญชีของผู้ใช้ |
| ธนาคาร ShortCode | สตริง | รหัสย่อสถาบันของผู้ใช้ |
| ชื่อผู้ถือบัญชีธนาคาร | สตริง | ชื่อบัญชีที่ต้องการส่งเงินไป |
| ชื่อธนาคาร | สตริง | ชื่อของสถาบัน |
| สถานะการตั้งถิ่นฐาน | สตริง | สถานะของการชำระธุรกรรม |
❗️ หมายเหตุสำคัญเกี่ยวกับการตอบกลับของ API
หากระบบของคุณไม่ได้รับการตอบกลับ HTTP 200 พร้อมด้วยสถานะธุรกรรมที่ถูกต้อง (กำลังประมวลผล เสร็จสมบูรณ์ หรือล้มเหลว) คุณต้องไม่ตั้งค่าสถานะธุรกรรมว่าสำเร็จหรือล้มเหลว
การตอบสนองที่ไม่ใช่ 200 (เช่น หมดเวลา ข้อผิดพลาด 5xx หรือไม่ตอบสนอง) หมายความว่าผลลัพธ์ไม่แน่นอน และคุณควรถือว่าธุรกรรมอยู่ระหว่างดำเนินการจนกว่าคุณจะยืนยันสถานะผ่านสถานะ API