QR Code แบบไดนามิก

Server

Download schema

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

POST

https://sandbox.onebrick.io/v2/payments/general

/qris/dynamic

APIs แบบสแตนด์อโลนเพื่อให้ลูกค้าใช้งานผลิตภัณฑ์ QR Code API นี้จะช่วยให้ไคลเอ็นต์สร้างไดนามิก QR Code ใหม่สำหรับลูกค้า

สร้างไดนามิก 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

error

POST/qris/dynamic

curl https://sandbox.onebrick.io/v2/payments/general/qris/dynamic \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "referenceId": "referenceId",
  "amount": 0,
  "validityPeriod": "validityPeriod"
}'

Example Request Body

{
  "referenceId": "referenceId",
  "amount": 0,
  "validityPeriod": "validityPeriod"
}

json

Example Responses

{
    "status": 200,
    "data": {
        "message": "We have successfully generated the dynamic qris",
        "id":"QR_7d13c668fea84081832d02368c61af69",
        "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": "00020101021226670016COM.NOBUBANK.WWW01189360050300000491530214082500000318170303UKE51440014ID.CO.QR Code.WWW0215ID20200814004210303UKE5204549953033605405100005802ID5914BRICK PAYMENT 6015Banten - Kota T61051581162570114011200010968090620202401121013231606140703A010804POSP630443C4"
    },
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null
}

json

application/json

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

GET

https://sandbox.onebrick.io/v2/payments/general

/qris/dynamic/{referenceId}

APIs นี้จะช่วยให้ลูกค้าเริ่มต้นการอัปเดตสถานะจากฝั่งของตน โดยจะต้องส่งธุรกรรม referenceId และรับการอัปเดต

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

referenceId

string · required

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

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

200

status

integer

Default: 0

object

error

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

POST

https://sandbox.onebrick.io/v2/payments/general

/qris/update-status-sandbox

API นี้ใช้สำหรับการทดสอบเท่านั้น และสามารถใช้ได้ในสภาพแวดล้อมแบบแซนด์บ็อกซ์เท่านั้น

การทดสอบ 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

Virtual Account QR Code แบบคงที่

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

POST

https://sandbox.onebrick.io/v2/payments/general

/qris/dynamic

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

referenceId

string · required

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

amount

integer · int32 · required

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

validityPeriod

string

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

200

status

integer

Default: 0

object

error

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

GET

https://sandbox.onebrick.io/v2/payments/general

/qris/dynamic/{referenceId}

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

referenceId

string · required

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

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

200

status

integer

Default: 0

object

error

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

POST

https://sandbox.onebrick.io/v2/payments/general

/qris/update-status-sandbox

การทดสอบ 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