Brick API Documentation
Brick
Brick API

QR Code SNAP

Server

สร้างและค้นหาการชำระเงิน QRIS โดยใช้จุดสิ้นสุดและส่วนหัวที่เข้ากันได้กับ SNAP ใช้ตำแหน่งข้อมูลเหล่านี้เมื่อการรวมของคุณเป็นไปตามมาตรฐาน SNAP ของอินโดนีเซียสำหรับโทเค็นการเข้าถึง ลายเซ็น การประทับเวลา และโฟลว์ QR MPM


รับ Access Token (SNAP)

POST
https://sandbox.onebrick.io
/v2/payments/acceptance/1.0/access-token/b2b

สร้างโทเค็นการเข้าถึง SNAP B2B ที่จำเป็นสำหรับตำแหน่งข้อมูล QR Code SNAP ส่งส่วนหัว SNAP, ลายเซ็น, การประทับเวลา และคีย์ไคลเอ็นต์ที่จำเป็นตามการตั้งค่าข้อมูลรับรอง Brick SNAP ของคุณ ใช้โทเค็นที่ส่งคืนเมื่อสร้างการชำระเงิน QR MPM หรือค้นหาสถานะการชำระเงิน QR ผ่านโฟลว์ที่เข้ากันได้กับ SNAP

รับ Access Token (SNAP) › Headers

Content-Type
​string · required

สตริงหมายถึงระบุประเภทสื่อของทรัพยากร

Default: application/json
X-CLIENT-KEY
​string · required

client_id ของลูกค้า

Default: YOUR_CLIENT_ID
X-TIMESTAMP
​string · date · required

เวลาท้องถิ่นปัจจุบันของลูกค้าในรูปแบบ yyyy-MM- ddTHH:mm:ss.SSSTZD

Default: 2024-11-11T18:44:33+07:00
X-SIGNATURE
​string · required

ลายเซ็นตรวจสอบการไม่ปฏิเสธและความสมบูรณ์สำหรับการร้องขอ

Default: YOUR_SIGNATURE

รับ Access Token (SNAP) › Request Body

grant_type
​string · required

ต้องเป็น "client_credentials"

Default: client_credentials

รับ Access Token (SNAP) › Responses

200

responseCode
​string
responseMessage
​string
accessToken
​string
tokenType
​string
expiresIn
​string

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

POST
https://sandbox.onebrick.io
/v2/payments/acceptance/1.0/qr/qr-mpm-generate

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

สร้างไดนามิก QR Code (SNAP) › Headers

Content-Type
​string · required

สตริงหมายถึงระบุประเภทสื่อของทรัพยากร

Default: application/json
X-CLIENT-KEY
​string · required

client_id ของลูกค้า

Default: YOUR_CLIENT_ID
X-TIMESTAMP
​string · date · required

เวลาท้องถิ่นปัจจุบันของลูกค้าในรูปแบบ yyyy-MM- ddTHH:mm:ss.SSSTZD

Default: 2024-11-15T18:44:33+07:00
Authorization
​string · required

โทเค็นการเข้าถึงครั้งเดียวที่สร้างขึ้นโดยใช้โทเค็นการรับรองความถูกต้อง API

Default: Bearer YOUR_ACCESS_TOKEN
X-SIGNATURE
​string · required

ลายเซ็นตรวจสอบการไม่ปฏิเสธและความสมบูรณ์สำหรับการร้องขอ

Default: YOUR_SIGNATURE
X-PARTNER-ID
​string · required

ลูกค้าของ Brick ID

Default: YOUR_PARTNER_ID
X-EXTERNAL-ID
​string · required

ตัวระบุภายนอกที่ไม่ซ้ำกันสำหรับคำขอ API ที่สามารถพบได้ใน Brick Dashboard Credentials

Default: external-id-unique-per-request
CHANNEL-ID
​string · required

ไอดีช่อง Brick

Default: A0

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

partnerReferenceNo
​string · required

หมายเลขอ้างอิงเฉพาะที่คู่ค้าให้มาเพื่อระบุธุรกรรม ความยาวสูงสุด 25 ตัวอักษร)

Default: 2025111500000000000001
validityPeriod
​string · required

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

Default: 600
​object

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

200

responseCode
​string
responseMessage
​string
referenceNo
​string
partnerReferenceNo
​string
qrContent
​string

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

POST
https://sandbox.onebrick.io
/v2/payments/acceptance/1.0/qr/qr-mpm-query

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

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

Content-Type
​string · required

สตริงหมายถึงระบุประเภทสื่อของทรัพยากร

Default: application/json
X-CLIENT-KEY
​string · required

client_id ของลูกค้า

Default: YOUR_CLIENT_ID
X-TIMESTAMP
​string · date · required

เวลาท้องถิ่นปัจจุบันของลูกค้าในรูปแบบ yyyy-MM- ddTHH:mm:ss.SSSTZD

Default: 2024-11-15T18:44:33+07:00
Authorization
​string · required

โทเค็นการเข้าถึงครั้งเดียวที่สร้างขึ้นโดยใช้โทเค็นการรับรองความถูกต้อง API

Default: Bearer YOUR_ACCESS_TOKEN
X-SIGNATURE
​string · required

ลายเซ็นตรวจสอบการไม่ปฏิเสธและความสมบูรณ์สำหรับการร้องขอ

Default: YOUR_SIGNATURE
X-PARTNER-ID
​string · required

ลูกค้าของ Brick ID

Default: YOUR_PARTNER_ID
X-EXTERNAL-ID
​string · required

ตัวระบุภายนอกที่ไม่ซ้ำกันสำหรับคำขอ API ที่สามารถพบได้ใน Brick Dashboard Credentials

Default: external-id-unique-per-request
CHANNEL-ID
​string · required

ไอดีช่อง Brick

Default: A0

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

originalReferenceNo
​string

ตัวระบุที่ไม่ซ้ำสำหรับธุรกรรมดั้งเดิม เช่น QR_75ae1b56c40449ecbc42010e3d2589cc

Default: QR_75ae1b56c40449ecbc42010e3d2589cc
originalPartnerReferenceNo
​string

ตัวระบุที่ไม่ซ้ำสำหรับธุรกรรมเดิมที่ได้รับมอบหมายจากพันธมิตร เช่น 20241115000000189723

Default: 20241115000000189723
serviceCode
​string

ต้องตั้งค่าเป็น '51'

Default: 51

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

200

responseCode
​string
responseMessage
​string
originalReferenceNo
​string
originalPartnerReferenceNo
​string
serviceCode
​string
latestTransactionStatus
​string
transactionStatusDesc
​string
​object