QR Code SNAP

Server

Buat dan kueri pembayaran QRIS menggunakan titik akhir dan header yang kompatibel dengan SNAP. Gunakan titik akhir ini ketika integrasi Anda mengikuti standar SNAP Indonesia untuk token akses, tanda tangan, stempel waktu, dan alur QR MPM.

Dapatkan Access Token (SNAP)

POST

https://sandbox.onebrick.io

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

Hasilkan token akses SNAP B2B yang diperlukan untuk titik akhir QR Code SNAP. Kirim header SNAP, tanda tangan, stempel waktu, dan kunci klien yang diperlukan sesuai dengan pengaturan kredensial Brick SNAP Anda. Gunakan token yang dikembalikan saat membuat pembayaran QR MPM atau menanyakan status pembayaran QR melalui alur yang kompatibel dengan SNAP.

Dapatkan Access Token (SNAP) › Headers

Content-Type

string · required

String mewakili menunjukkan jenis media sumber daya

Default: application/json

X-CLIENT-KEY

string · required

Client_id klien

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

X-TIMESTAMP

string · date · required

Waktu lokal klien saat ini dalam format yyyy-MM- ddTHH:mm:ss.SSSTZD

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

X-SIGNATURE

string · required

Tanda tangan pemeriksaan Non-Penyangkalan & Integritas untuk permintaan

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

Dapatkan Access Token (SNAP) › Request Body

grant_type

string · required

Harus berupa "kredensial_klien"

Default: client_credentials

Dapatkan 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

Generate Dynamic QR Code (SNAP)

POST

https://sandbox.onebrick.io

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

Buat pembayaran QRIS MPM dinamis menggunakan header permintaan yang kompatibel dengan SNAP dan struktur payload. Gunakan endpoint ini ketika integrasi Anda mengikuti standar SNAP Indonesia untuk pembuatan pembayaran QR, termasuk tanda tangan, stempel waktu, referensi mitra, dan informasi pedagang. Responsnya mengembalikan konten dan pengidentifikasi QR yang harus direkonsiliasi melalui penyelidikan status SNAP atau callbacks.

Generate Dynamic QR Code (SNAP) › Headers

Content-Type

string · required

String mewakili menunjukkan jenis media sumber daya

Default: application/json

X-CLIENT-KEY

string · required

Client_id klien

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

X-TIMESTAMP

string · date · required

Waktu lokal klien saat ini dalam format yyyy-MM- ddTHH:mm:ss.SSSTZD

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

Authorization

string · required

Token akses satu kali dibuat menggunakan token autentikasi API

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

X-SIGNATURE

string · required

Tanda tangan pemeriksaan Non-Penyangkalan & Integritas untuk permintaan

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

X-PARTNER-ID

string · required

klien Brick ID

Default: 1

X-EXTERNAL-ID

string · required

Pengidentifikasi eksternal unik untuk permintaan API yang dapat ditemukan di Kredensial Dasbor Brick

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

CHANNEL-ID

string · required

id saluran Brick

Default: A0

Generate Dynamic QR Code (SNAP) › Request Body

partnerReferenceNo

string · required

Nomor referensi unik yang diberikan oleh mitra untuk mengidentifikasi transaksi. Panjang maksimal 25 karakter)

Default: 2025111500000000000001

validityPeriod

string · required

Minimum 600 detik (10 menit), maksimum 86.400 detik (24 jam) dari waktu pembuatan. Jika tidak disetel, nilai defaultnya adalah 86.400 detik (24 jam)

Default: 600

object

Generate Dynamic 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

Status Dynamic QR Code

POST

https://sandbox.onebrick.io

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

Kueri status pembayaran terbaru untuk transaksi QRIS SNAP dinamis. Gunakan endpoint ini ketika sistem Anda perlu mengonfirmasi status pembayaran QR MPM menggunakan header SNAP, stempel waktu, tanda tangan, dan data referensi mitra asli. Responsnya membantu merekonsiliasi transaksi QR yang tertunda, berhasil, gagal, atau kedaluwarsa dalam integrasi berbasis SNAP.

Status Dynamic QR Code › Headers

Content-Type

string · required

String mewakili menunjukkan jenis media sumber daya

Default: application/json

X-CLIENT-KEY

string · required

Client_id klien

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

X-TIMESTAMP

string · date · required

Waktu lokal klien saat ini dalam format yyyy-MM- ddTHH:mm:ss.SSSTZD

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

Authorization

string · required

Token akses satu kali dibuat menggunakan token autentikasi API

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

X-SIGNATURE

string · required

Tanda tangan pemeriksaan Non-Penyangkalan & Integritas untuk permintaan

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

X-PARTNER-ID

string · required

klien Brick ID

Default: 1

X-EXTERNAL-ID

string · required

Pengidentifikasi eksternal unik untuk permintaan API yang dapat ditemukan di Kredensial Dasbor Brick

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

CHANNEL-ID

string · required

id saluran Brick

Default: A0

Status Dynamic QR Code › Request Body

originalReferenceNo

string

Pengidentifikasi unik untuk transaksi asli. misalnya QR_75ae1b56c40449ecbc42010e3d2589cc

Default: QR_75ae1b56c40449ecbc42010e3d2589cc

originalPartnerReferenceNo

string

Pengidentifikasi unik untuk transaksi asli yang diberikan oleh mitra. misalnya 20241115000000189723

Default: 20241115000000189723

serviceCode

string

Harus disetel ke '51'

Default: 51

Status Dynamic 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 Statis Open VA

Dapatkan Access Token (SNAP)

POST

https://sandbox.onebrick.io

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

Dapatkan Access Token (SNAP) › Headers

Content-Type

string · required

String mewakili menunjukkan jenis media sumber daya

Default: application/json

X-CLIENT-KEY

string · required

Client_id klien

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

X-TIMESTAMP

string · date · required

Waktu lokal klien saat ini dalam format yyyy-MM- ddTHH:mm:ss.SSSTZD

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

X-SIGNATURE

string · required

Tanda tangan pemeriksaan Non-Penyangkalan & Integritas untuk permintaan

Dapatkan Access Token (SNAP) › Request Body

grant_type

string · required

Harus berupa "kredensial_klien"

Default: client_credentials

Dapatkan Access Token (SNAP) › Responses

200

responseCode

string

responseMessage

string

accessToken

string

tokenType

string

expiresIn

string

Generate Dynamic QR Code (SNAP)

POST

https://sandbox.onebrick.io

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

Generate Dynamic QR Code (SNAP) › Headers

Content-Type

string · required

String mewakili menunjukkan jenis media sumber daya

Default: application/json

X-CLIENT-KEY

string · required

Client_id klien

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

X-TIMESTAMP

string · date · required

Waktu lokal klien saat ini dalam format yyyy-MM- ddTHH:mm:ss.SSSTZD

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

Authorization

string · required

Token akses satu kali dibuat menggunakan token autentikasi API

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

X-SIGNATURE

string · required

Tanda tangan pemeriksaan Non-Penyangkalan & Integritas untuk permintaan

X-PARTNER-ID

string · required

klien Brick ID

Default: 1

X-EXTERNAL-ID

string · required

Pengidentifikasi eksternal unik untuk permintaan API yang dapat ditemukan di Kredensial Dasbor Brick

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

CHANNEL-ID

string · required

id saluran Brick

Default: A0

Generate Dynamic QR Code (SNAP) › Request Body

partnerReferenceNo

string · required

Nomor referensi unik yang diberikan oleh mitra untuk mengidentifikasi transaksi. Panjang maksimal 25 karakter)

Default: 2025111500000000000001

validityPeriod

string · required

Minimum 600 detik (10 menit), maksimum 86.400 detik (24 jam) dari waktu pembuatan. Jika tidak disetel, nilai defaultnya adalah 86.400 detik (24 jam)

Default: 600

object

Generate Dynamic QR Code (SNAP) › Responses

200

responseCode

string

responseMessage

string

referenceNo

string

partnerReferenceNo

string

qrContent

string

Status Dynamic QR Code

POST

https://sandbox.onebrick.io

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

Status Dynamic QR Code › Headers

Content-Type

string · required

String mewakili menunjukkan jenis media sumber daya

Default: application/json

X-CLIENT-KEY

string · required

Client_id klien

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

X-TIMESTAMP

string · date · required

Waktu lokal klien saat ini dalam format yyyy-MM- ddTHH:mm:ss.SSSTZD

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

Authorization

string · required

Token akses satu kali dibuat menggunakan token autentikasi API

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

X-SIGNATURE

string · required

Tanda tangan pemeriksaan Non-Penyangkalan & Integritas untuk permintaan

X-PARTNER-ID

string · required

klien Brick ID

Default: 1

X-EXTERNAL-ID

string · required

Pengidentifikasi eksternal unik untuk permintaan API yang dapat ditemukan di Kredensial Dasbor Brick

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

CHANNEL-ID

string · required

id saluran Brick

Default: A0

Status Dynamic QR Code › Request Body

originalReferenceNo

string

Pengidentifikasi unik untuk transaksi asli. misalnya QR_75ae1b56c40449ecbc42010e3d2589cc

Default: QR_75ae1b56c40449ecbc42010e3d2589cc

originalPartnerReferenceNo

string

Pengidentifikasi unik untuk transaksi asli yang diberikan oleh mitra. misalnya 20241115000000189723

Default: 20241115000000189723

serviceCode

string

Harus disetel ke '51'

Default: 51

Status Dynamic QR Code › Responses

200

responseCode

string

responseMessage

string

originalReferenceNo

string

originalPartnerReferenceNo

string

serviceCode

string

latestTransactionStatus

string

transactionStatusDesc

string

object