QR Code SNAP

Server

Download schema

Dapatkan Access Token (SNAP)

POST

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

/acceptance/1.0/access-token/b2b

Hasilkan token akses SNAP B2B yang digunakan untuk pembuatan QR Code SNAP dan penyelidikan status.

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/acceptance/1.0/access-token/b2b

curl https://sandbox.onebrick.io/v2/payments/general/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/general

/acceptance/1.0/qr/qr-mpm-generate

Kita perlu membangun satu APIs mandiri agar klien dapat menggunakan produk QR Code. API ini akan membantu klien membuat QR Code dinamis baru untuk klien.

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 maksimum 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/acceptance/1.0/qr/qr-mpm-generate

curl https://sandbox.onebrick.io/v2/payments/general/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/general

/acceptance/1.0/qr/qr-mpm-query

APIs ini akan membantu klien untuk menginisialisasi pembaruan status dari pihak mereka.

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/acceptance/1.0/qr/qr-mpm-query

curl https://sandbox.onebrick.io/v2/payments/general/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 Ewallet

Dapatkan Access Token (SNAP)

POST

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

/acceptance/1.0/access-token/b2b

Hasilkan token akses SNAP B2B yang digunakan untuk pembuatan QR Code SNAP dan penyelidikan status.

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/general

/acceptance/1.0/qr/qr-mpm-generate

Kita perlu membangun satu APIs mandiri agar klien dapat menggunakan produk QR Code. API ini akan membantu klien membuat QR Code dinamis baru untuk klien.

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 maksimum 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/general

/acceptance/1.0/qr/qr-mpm-query

APIs ini akan membantu klien untuk menginisialisasi pembaruan status dari pihak mereka.

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