Copy page

ไดนามิก QR Code

Dynamic QR Code คือขั้นตอนการชำระเงิน Brick QRIS สำหรับการสร้างโค้ด QR แบบครั้งเดียวพร้อมจำนวนเงินที่กำหนดไว้ล่วงหน้า ใช้ Dynamic QR Code เมื่อการชำระเงิน QRIS แต่ละรายการควรจับคู่กับคำสั่งซื้อ ใบแจ้งหนี้ การชำระเงิน หรือการอ้างอิงธุรกรรมที่เฉพาะเจาะจง

ก่อนใช้ Dynamic QR Code ให้สร้างและยืนยันผู้ขาย QR Code ดู Registering for QR Code จากนั้นทำตามขั้นตอนการรวมด้านล่าง

คู่มือบูรณาการ

1. การสร้างโค้ด QR แบบไดนามิก

หากต้องการเริ่มสร้างโค้ด QR แบบไดนามิก คุณสามารถใช้ Dynamic QR API พร้อมรายละเอียดเหล่านี้:

Code
curl --location 'https://sandbox.onebrick.io/v2/payments/gs/qris/dynamic' \
--header 'publicAccessToken: Bearer {{publicAccessToken}}' \
--header 'Content-Type: application/json' \
--data '{
    "referenceId":"test-qris-sandbox",
    "amount":10000,
    "validityPeriod":"86400"
}'

คุณจะได้รับคำตอบดังนี้เมื่อทำสำเร็จ:

Code
{
    "status": 200,
    "data": {
        "message": "We have successfully generated the dynamic qris",
        "id":"QR_XXXX",
        "referenceId": "test-qris-sandbox",
        "amount": 10000,
        "createdAt": "2024-01-16T17:00:00.000+07:00",
        "expiredAt": "2024-01-17T17:00:00.000+07:00",
        "qrData": "XXXX"
    },
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null
}

2. การแจ้งเตือนการโทรกลับ

Brick แจ้งให้คุณทราบเมื่อผู้ใช้ชำระเงินผ่านการโทรกลับแล้ว

การโทรกลับจะได้รับเมื่อผู้ใช้ชำระเงินแล้ว

Code
{
  "data": {
    "id": "QR_XXXX",
    "referenceId": "XXXX",
    "amount": 11000,
    "status": "PAID",
    "createdAt": "2024-03-13T16:58:37.000+07:00",
    "paidAt": "2024-03-13T23:58:58.000+07:00",
    "qrisType": "DYNAMIC",
    "merchant": "merchant_name",
    "merchantNmid": "merchant_Nmid"
  }
}

📘 การตั้งค่า URL โทรกลับ QR Code ของคุณ

ในตอนนี้การตั้งค่าการโทรกลับ QR Code จำเป็นต้องดำเนินการด้วยตนเอง คุณสามารถติดต่อทีม Brick เพื่อตั้งค่า URL โทรกลับ QR Code ของคุณได้

3. ตรวจสอบสถานะรหัส QR

ใช้จุดสิ้นสุดของสถานะเพื่อดึงข้อมูลสถานะ Dynamic QR Code ล่าสุดโดยส่งธุรกรรม referenceId

Code
curl --location 'https://sandbox.onebrick.io/v2/payments/gs/qris/dynamic/{{referenceId}}' \
--header 'publicAccessToken: Bearer {{publicAccessToken}}'

คุณจะได้รับคำตอบเหมือนด้านล่าง

Code
{
    "status": 200,
    "data": {
        "referenceId": "XXXX",
        "id": "QR_XXXX",
        "amount": 10000,
        "status": "completed",
        "qrData": "XXXX",
        "paidAt": "2024-03-09T00:53:07.000+07:00",
        "type": "DYNAMIC",
        "merchant": "merchant_name",
        "merchantNmid": "merchant_Nmid"
    },
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null
}

สถานะ QR Code ที่มีอยู่คือกำลังดำเนินการ ชำระเงิน หมดอายุ และยกเลิก

4. ยกเลิกรหัส QR

ใช้ตำแหน่งข้อมูลนี้เพื่อยกเลิก Dynamic QR Code เพื่อไม่ให้สามารถใช้งานได้อีกต่อไป

Code
curl --location --request POST 'https://sandbox.onebrick.io/v2/payments/gs/qris/dynamic/{{referenceId}}/cancel' \
--header 'publicAccessToken: Bearer {{publicAccessToken}}'

คุณจะได้รับคำตอบดังนี้

Code
{
    "status": 200,
    "data": {
        "message": "We have successfully cancel the qris",
        "id": "QR_XXXX",
        "referenceId": "test-qris-sandbox",
        "cancelledAt": "2024-01-20T17:00:00.000+07:00",
    },
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null
}