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: 66a5fc3b-7c57-4e29-b097-88b5909aedcc

X-TIMESTAMP

string · date · required

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

Default: 2024-11-11T18:44:33+07:00

X-SIGNATURE

string · required

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

Default: i10jpP3qxAU+K+YtHmqXTnd00tbAdloAMoJsi0W32T4mnGiaZB1JNtWm1DZetUXUE7+93VVn4L5F1YhqheElsjQBnaDmPUxDXWrT8cHakzKz/EYNGFhgnnGVokRLaBnDIP11ASFACt7P7dtTA3EFAoD65NbApyMmKkrPG8siQvyKylx5xHRCq2Zr3WNqWOP4MgCo862PNHNAapu54ikw3B9x1FW/BCTWlm0bzz51HXWvoneyF9boddKGjfDgFJYfVp58RJd8cgvqwCAV/+bzXzen0DqB9Yo2O3XCszD6yMVJz5dMvEkOwSyskILbJsSLa8JqRRh/j66jYLy8JBDOFg==

รับ 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

POST/v2/payments/acceptance/1.0/access-token/b2b

curl https://sandbox.onebrick.io/v2/payments/acceptance/1.0/access-token/b2b \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-CLIENT-KEY: 66a5fc3b-7c57-4e29-b097-88b5909aedcc' \
  --header 'X-TIMESTAMP: 2024-11-11T18:44:33+07:00' \
  --header 'X-SIGNATURE: i10jpP3qxAU+K+YtHmqXTnd00tbAdloAMoJsi0W32T4mnGiaZB1JNtWm1DZetUXUE7+93VVn4L5F1YhqheElsjQBnaDmPUxDXWrT8cHakzKz/EYNGFhgnnGVokRLaBnDIP11ASFACt7P7dtTA3EFAoD65NbApyMmKkrPG8siQvyKylx5xHRCq2Zr3WNqWOP4MgCo862PNHNAapu54ikw3B9x1FW/BCTWlm0bzz51HXWvoneyF9boddKGjfDgFJYfVp58RJd8cgvqwCAV/+bzXzen0DqB9Yo2O3XCszD6yMVJz5dMvEkOwSyskILbJsSLa8JqRRh/j66jYLy8JBDOFg==' \
  --data '{
  "grant_type": "client_credentials"
}'

Example Request Body

{
  "grant_type": "client_credentials"
}

json

Example Responses

{
  "responseCode": "2007300",
  "responseMessage": "Successful",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxNjQwIiwiZXhwIjoxNzMxNjYxODY4LCJuYmYiOjE3MzE2NjA5NjgsImlhdCI6MTczMTY2MDk2OH0.meLj72WwkmLTtMa47DUZDgs4EhbhWJbzgQhjTm0sUC4",
  "tokenType": "Bearer",
  "expiresIn": "900"
}

json

application/json

สร้างไดนามิก 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: 51de24a9-bf41-47eb-aacb-876a5c1ac323

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 eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxNjQwIiwiZXhwIjoxNzMxNjYzMDUwLCJuYmYiOjE3MzE2NjIxNTAsImlhdCI6MTczMTY2MjE1MH0.4horeyrklK5JYdAh5KBMK7GS5LbMWPKb-3KA0qDajcg

X-SIGNATURE

string · required

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

Default: LBNvcwqen4CC4dypLMlyu4JBCzUsbXtefg6SymbEN9vIL08tckTsJkeRo+dGVLB6qC7lRkf60Y1ND1HL2KCp24q8Vz3mSUr8wRxIh9wMRRf6BVRFcZAa3tX5jO0VW58+AEevT/rl9jssm314w70l+6Uivjj8tdbvVv07EUyz775Vx2TUQ9xrdCCe2W+KzbUDsy7YKx/tsOZgbtrOekgH7RL/lmhFrcgk2uheyoo0iIt+zUwaWzjqqfqCPaXcDczgCI8DNAz3cT5GbhJzNLNVYDHlb9OLMN5Dkvgsh8zx2m0zRUWyVQDUQmp0vL7UU7lMD5Dj7uOakugnTC/xpey+rQ==

X-PARTNER-ID

string · required

ลูกค้าของ Brick ID

Default: 1

X-EXTERNAL-ID

string · required

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

Default: 80deeaaf-c433-46eb-b771-b6c3ff0950e3

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

POST/v2/payments/acceptance/1.0/qr/qr-mpm-generate

curl https://sandbox.onebrick.io/v2/payments/acceptance/1.0/qr/qr-mpm-generate \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-CLIENT-KEY: 51de24a9-bf41-47eb-aacb-876a5c1ac323' \
  --header 'X-TIMESTAMP: 2024-11-15T18:44:33+07:00' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxNjQwIiwiZXhwIjoxNzMxNjYzMDUwLCJuYmYiOjE3MzE2NjIxNTAsImlhdCI6MTczMTY2MjE1MH0.4horeyrklK5JYdAh5KBMK7GS5LbMWPKb-3KA0qDajcg' \
  --header 'X-SIGNATURE: LBNvcwqen4CC4dypLMlyu4JBCzUsbXtefg6SymbEN9vIL08tckTsJkeRo+dGVLB6qC7lRkf60Y1ND1HL2KCp24q8Vz3mSUr8wRxIh9wMRRf6BVRFcZAa3tX5jO0VW58+AEevT/rl9jssm314w70l+6Uivjj8tdbvVv07EUyz775Vx2TUQ9xrdCCe2W+KzbUDsy7YKx/tsOZgbtrOekgH7RL/lmhFrcgk2uheyoo0iIt+zUwaWzjqqfqCPaXcDczgCI8DNAz3cT5GbhJzNLNVYDHlb9OLMN5Dkvgsh8zx2m0zRUWyVQDUQmp0vL7UU7lMD5Dj7uOakugnTC/xpey+rQ==' \
  --header 'X-PARTNER-ID: 1' \
  --header 'X-EXTERNAL-ID: 80deeaaf-c433-46eb-b771-b6c3ff0950e3' \
  --header 'CHANNEL-ID: A0' \
  --data '{
  "partnerReferenceNo": "2025111500000000000001",
  "amount": {
    "value": "10000.00",
    "currency": "IDR"
  },
  "validityPeriod": "600"
}'

Example Request Body

{
  "partnerReferenceNo": "2025111500000000000001",
  "amount": {
    "value": "10000.00",
    "currency": "IDR"
  },
  "validityPeriod": "600"
}

json

Example Responses

{
    "responseCode": "2004700",
    "responseMessage": "Successful",
    "referenceNo": "QR_429529d44e1f4e22a167a8b0597f1226",
    "partnerReferenceNo": "87457990831641724058",
    "qrContent": "00020101021226640015ID.OTTOCASH.WWW01189360081110020080020212OP1D012981900303UME51440014ID.CO.QR Code.WWW0215ID10243527937710303UME520499995303360540410005802ID5910TULOBRICK16015JL KARYA BHAKTI61057812162720120BILL14155627188675030521SP17395233874158600180703A019612OP1D012981906304A393"
}

json

application/json

สถานะสำหรับไดนามิก 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: 51de24a9-bf41-47eb-aacb-876a5c1ac323

X-TIMESTAMP

string · date · required

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

Default: 2024-11-15T18:44:33+07:00

Authorization

string · required

Default: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxNjQwIiwiZXhwIjoxNzMxNjYzMDUwLCJuYmYiOjE3MzE2NjIxNTAsImlhdCI6MTczMTY2MjE1MH0.4horeyrklK5JYdAh5KBMK7GS5LbMWPKb-3KA0qDajcg

X-SIGNATURE

string · required

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

Default: B1P/3XL7Y2TCYOs81Xwni9wr3NaPcA6WJQ/qnY35ZGEUOhrIZTrxfVzM8UHR/e0gsNtbLhJ9OnHz3wAVljFpFowdpwG1OsYE9EbRCUBhyaFIxnn7VTAD/09yEyxTxEdeHa6GWlFw+cmNHLmvxCLM07DMTdYXOlK2VjKmFr3uG1wOwvUOejAtRCl+mukHnT/e94auHeUYeGPBOMmFC6UVzLKLLqGikytgx5V6JDUzC73lyyFrrKChIq0mF9EwhNOGj0n9UJZZi0/kOAOFlFSh4qQEqwrMsXWu51b1FohGMCPwUuDS3z3YRO4mQ+mOfgQU3EpzHJ3uM2oYLRk5mJXRA==

X-PARTNER-ID

string · required

ลูกค้าของ Brick ID

Default: 1

X-EXTERNAL-ID

string · required

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

Default: 5f227e48-d589-44e7-b2e0-87f733fed23e

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

POST/v2/payments/acceptance/1.0/qr/qr-mpm-query

curl https://sandbox.onebrick.io/v2/payments/acceptance/1.0/qr/qr-mpm-query \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-CLIENT-KEY: 51de24a9-bf41-47eb-aacb-876a5c1ac323' \
  --header 'X-TIMESTAMP: 2024-11-15T18:44:33+07:00' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxNjQwIiwiZXhwIjoxNzMxNjYzMDUwLCJuYmYiOjE3MzE2NjIxNTAsImlhdCI6MTczMTY2MjE1MH0.4horeyrklK5JYdAh5KBMK7GS5LbMWPKb-3KA0qDajcg' \
  --header 'X-SIGNATURE: B1P/3XL7Y2TCYOs81Xwni9wr3NaPcA6WJQ/qnY35ZGEUOhrIZTrxfVzM8UHR/e0gsNtbLhJ9OnHz3wAVljFpFowdpwG1OsYE9EbRCUBhyaFIxnn7VTAD/09yEyxTxEdeHa6GWlFw+cmNHLmvxCLM07DMTdYXOlK2VjKmFr3uG1wOwvUOejAtRCl+mukHnT/e94auHeUYeGPBOMmFC6UVzLKLLqGikytgx5V6JDUzC73lyyFrrKChIq0mF9EwhNOGj0n9UJZZi0/kOAOFlFSh4qQEqwrMsXWu51b1FohGMCPwUuDS3z3YRO4mQ+mOfgQU3EpzHJ3uM2oYLRk5mJXRA==' \
  --header 'X-PARTNER-ID: 1' \
  --header 'X-EXTERNAL-ID: 5f227e48-d589-44e7-b2e0-87f733fed23e' \
  --header 'CHANNEL-ID: A0' \
  --data '{
  "originalReferenceNo": "QR_75ae1b56c40449ecbc42010e3d2589cc",
  "originalPartnerReferenceNo": "20241115000000189723",
  "serviceCode": "51"
}'

Example Request Body

{
  "originalReferenceNo": "QR_75ae1b56c40449ecbc42010e3d2589cc",
  "originalPartnerReferenceNo": "20241115000000189723",
  "serviceCode": "51"
}

json

Example Responses

{
  "responseCode": "2005100",
  "responseMessage": "Successful",
  "originalReferenceNo": "QR_75ae1b56c40449ecbc42010e3d2589cc",
  "originalPartnerReferenceNo": "20241115000000189723",
  "serviceCode": "51",
  "latestTransactionStatus": "06",
  "transactionStatusDesc": "EXPIRED",
  "amount": {
    "value": "10000.00",
    "currency": "IDR"
  }
}

json

application/json

QR Code แบบคงที่Open VA

รับ Access Token (SNAP)

POST

https://sandbox.onebrick.io

/v2/payments/acceptance/1.0/access-token/b2b

รับ Access Token (SNAP) › Headers

Content-Type

string · required

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

Default: application/json

X-CLIENT-KEY

string · required

client_id ของลูกค้า

Default: 66a5fc3b-7c57-4e29-b097-88b5909aedcc

X-TIMESTAMP

string · date · required

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

Default: 2024-11-11T18:44:33+07:00

X-SIGNATURE

string · required

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

รับ 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

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

Content-Type

string · required

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

Default: application/json

X-CLIENT-KEY

string · required

client_id ของลูกค้า

Default: 51de24a9-bf41-47eb-aacb-876a5c1ac323

X-TIMESTAMP

string · date · required

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

Default: 2024-11-15T18:44:33+07:00

Authorization

string · required

Default: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxNjQwIiwiZXhwIjoxNzMxNjYzMDUwLCJuYmYiOjE3MzE2NjIxNTAsImlhdCI6MTczMTY2MjE1MH0.4horeyrklK5JYdAh5KBMK7GS5LbMWPKb-3KA0qDajcg

X-SIGNATURE

string · required

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

X-PARTNER-ID

string · required

ลูกค้าของ Brick ID

Default: 1

X-EXTERNAL-ID

string · required

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

Default: 80deeaaf-c433-46eb-b771-b6c3ff0950e3

CHANNEL-ID

string · required

ไอดีช่อง Brick

Default: A0

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

partnerReferenceNo

string · required

Default: 2025111500000000000001

validityPeriod

string · required

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

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

Content-Type

string · required

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

Default: application/json

X-CLIENT-KEY

string · required

client_id ของลูกค้า

Default: 51de24a9-bf41-47eb-aacb-876a5c1ac323

X-TIMESTAMP

string · date · required

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

Default: 2024-11-15T18:44:33+07:00

Authorization

string · required

Default: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxNjQwIiwiZXhwIjoxNzMxNjYzMDUwLCJuYmYiOjE3MzE2NjIxNTAsImlhdCI6MTczMTY2MjE1MH0.4horeyrklK5JYdAh5KBMK7GS5LbMWPKb-3KA0qDajcg

X-SIGNATURE

string · required

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

X-PARTNER-ID

string · required

ลูกค้าของ Brick ID

Default: 1

X-EXTERNAL-ID

string · required

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

Default: 5f227e48-d589-44e7-b2e0-87f733fed23e

CHANNEL-ID

string · required

ไอดีช่อง Brick

Default: A0

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

originalReferenceNo

string

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

Default: QR_75ae1b56c40449ecbc42010e3d2589cc

originalPartnerReferenceNo

string

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