Copy page

ไดนามิก QRIS

การสร้างพ่อค้า

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

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

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 โทรกลับ QRIS ของคุณ

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

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

APIs นี้จะช่วยให้ลูกค้าเริ่มต้นการอัปเดตสถานะจากฝั่งของตนได้ พวกเขาต้องส่งต่อธุรกรรม 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
}

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

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

APIs นี้จะช่วยยกเลิก QRIS จึงไม่สามารถใช้งานได้

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
}