Brick API Documentation
Brick
Brick API

QR Code Dynamic

Server

สร้าง ทดสอบ และตรวจสอบรหัส QRIS QR แบบไดนามิกสำหรับการชำระเงินของลูกค้า รหัส QR แบบไดนามิกถูกสร้างขึ้นต่อธุรกรรม และควรปรับยอดผ่าน callbacks หรือการสอบถามสถานะ


สร้างไดนามิก QR Code

POST
https://sandbox.onebrick.io
/v2/payments/gs/qris/dynamic
publicAccessToken (header)

สร้าง QRIS QR Code แบบไดนามิกสำหรับจำนวนเงินที่ชำระเฉพาะและ reference ID ใช้ endpoint นี้เมื่อธุรกรรมของลูกค้าทุกรายการจำเป็นต้องมี QR payload ที่ไม่ซ้ำกันสำหรับการเรียกเก็บเงิน การตอบกลับประกอบด้วยข้อมูล QR ที่สามารถแสดงผลได้ในขั้นตอนการชำระเงินของคุณ ในขณะที่สถานะการชำระเงินขั้นสุดท้ายควรได้รับการยืนยันผ่าน callbacks หรือสถานะ QR แบบไดนามิก endpoint

สร้างไดนามิก QR Code › Request Body

referenceId
​string · required

การอ้างอิงเฉพาะของธุรกรรมจากฝั่งไคลเอ็นต์ (ความยาวสูงสุด 25 อักขระ)

amount
​integer · int32 · required

จำนวนเงินที่ลูกค้าต้องการโอน

validityPeriod
​string

ขั้นต่ำ 600 วินาที (10 นาที) สูงสุด 86,400 วินาที (24 ชั่วโมง) นับจากเวลาสร้าง หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นจะเป็น 86,400 วินาที (24 ชั่วโมง)

สร้างไดนามิก QR Code › Responses

200

status
​integer
Default: 0
​object
​object
error
​

สถานะสำหรับไดนามิก QR Code

GET
https://sandbox.onebrick.io
/v2/payments/gs/qris/dynamic/{referenceId}
publicAccessToken (header)

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

สถานะสำหรับไดนามิก QR Code › path Parameters

referenceId
​string · required

referenceId ที่ไม่ซ้ำของธุรกรรม

สถานะสำหรับไดนามิก QR Code › Responses

200

status
​integer
Default: 0
​object
​object
error
​

การทดสอบ QR Code ใน Sandbox

POST
https://sandbox.onebrick.io
/v2/payments/gs/qris/update-status-sandbox
publicAccessToken (header)

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

การทดสอบ QR Code ใน Sandbox › Request Body

referenceId
​string · required

referenceId ที่ไม่ซ้ำของธุรกรรม

status
​string · required

สถานะที่ต้องการบรรลุ (PAID/COMPLETED)

Default: PAID/COMPLETED

การทดสอบ QR Code ใน Sandbox › Responses

200

status
​integer
Default: 0
data
​string
​object
error
​