QRIS SNAP

Server

Generate Dynamic QRIS (SNAP)

POST

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

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

We need to build one standalone APIs for clients to consume of QRIS product. This API will help clients to create new dynamic QRIS for clients.

Generate Dynamic QRIS (SNAP) › Headers

Content-Type

string · required

String represents indicate the media type of the resource

Default: application/json

X-CLIENT-KEY

string · required

Client’s client_id

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

X-TIMESTAMP

string · date · required

Client's current local time in yyyy-MM- ddTHH:mm:ss.SSSTZD format

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

Authorization

string · required

One time access-token generated using the auth token API

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

X-SIGNATURE

string · required

Non-Repudiation & Integrity check signature for the requesting

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

X-PARTNER-ID

string · required

Brick's client ID

Default: 1

X-EXTERNAL-ID

string · required

Unique external identifier for the API request that can be found on Brick Dashboard Credentials

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

CHANNEL-ID

string · required

Brick's channel id

Default: A0

Generate Dynamic QRIS (SNAP) › Request Body

partnerReferenceNo

string · required

Unique reference number provided by the partner to identify the transaction. Maximum length of 25 characters)

Default: 2025111500000000000001

validityPeriod

string · required

Minimum 600 seconds (10 minutes), maximum 86,400 seconds (24 hours) from the creation time. If not set, the default value will be 86,400 seconds (24 hours)

Default: 600

object

Generate Dynamic QRIS (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.QRIS.WWW0215ID10243527937710303UME520499995303360540410005802ID5910TULOBRICK16015JL KARYA BHAKTI61057812162720120BILL14155627188675030521SP17395233874158600180703A019612OP1D012981906304A393"
}

json

application/json

Status for Dynamic QRIS

POST

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

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

This APIs will help clients to initialise the status update from their side.

Status for Dynamic QRIS › Headers

Content-Type

string · required

String represents indicate the media type of the resource

Default: application/json

X-CLIENT-KEY

string · required

Client’s client_id

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

X-TIMESTAMP

string · date · required

Client's current local time in yyyy-MM- ddTHH:mm:ss.SSSTZD format

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

Authorization

string · required

One time access-token generated using the auth token API

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

X-SIGNATURE

string · required

Non-Repudiation & Integrity check signature for the requesting

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

X-PARTNER-ID

string · required

Brick's client ID

Default: 1

X-EXTERNAL-ID

string · required

Unique external identifier for the API request that can be found on Brick Dashboard Credentials

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

CHANNEL-ID

string · required

Brick's channel id

Default: A0

Status for Dynamic QRIS › Request Body

originalReferenceNo

string

Unique identifier for the original transaction. e.g. QR_75ae1b56c40449ecbc42010e3d2589cc

Default: QR_75ae1b56c40449ecbc42010e3d2589cc

originalPartnerReferenceNo

string

Unique identifier for the original transaction assigned by the partner. e.g. 20241115000000189723

Default: 20241115000000189723

serviceCode

string

Must be set to '51'

Default: 51

Status for Dynamic QRIS › 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

QRIS Static E-wallet

Generate Dynamic QRIS (SNAP)

POST

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

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

We need to build one standalone APIs for clients to consume of QRIS product. This API will help clients to create new dynamic QRIS for clients.

Generate Dynamic QRIS (SNAP) › Headers

Content-Type

string · required

String represents indicate the media type of the resource

Default: application/json

X-CLIENT-KEY

string · required

Client’s client_id

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

X-TIMESTAMP

string · date · required

Client's current local time in yyyy-MM- ddTHH:mm:ss.SSSTZD format

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

Authorization

string · required

One time access-token generated using the auth token API

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

X-SIGNATURE

string · required

Non-Repudiation & Integrity check signature for the requesting

X-PARTNER-ID

string · required

Brick's client ID

Default: 1

X-EXTERNAL-ID

string · required

Unique external identifier for the API request that can be found on Brick Dashboard Credentials

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

CHANNEL-ID

string · required

Brick's channel id

Default: A0

Generate Dynamic QRIS (SNAP) › Request Body

partnerReferenceNo

string · required

Unique reference number provided by the partner to identify the transaction. Maximum length of 25 characters)

Default: 2025111500000000000001

validityPeriod

string · required

Minimum 600 seconds (10 minutes), maximum 86,400 seconds (24 hours) from the creation time. If not set, the default value will be 86,400 seconds (24 hours)

Default: 600

object

Generate Dynamic QRIS (SNAP) › Responses

200

responseCode

string

responseMessage

string

referenceNo

string

partnerReferenceNo

string

qrContent

string

Status for Dynamic QRIS

POST

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

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

This APIs will help clients to initialise the status update from their side.

Status for Dynamic QRIS › Headers

Content-Type

string · required

String represents indicate the media type of the resource

Default: application/json

X-CLIENT-KEY

string · required

Client’s client_id

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

X-TIMESTAMP

string · date · required

Client's current local time in yyyy-MM- ddTHH:mm:ss.SSSTZD format

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

Authorization

string · required

One time access-token generated using the auth token API

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

X-SIGNATURE

string · required

Non-Repudiation & Integrity check signature for the requesting

X-PARTNER-ID

string · required

Brick's client ID

Default: 1

X-EXTERNAL-ID

string · required

Unique external identifier for the API request that can be found on Brick Dashboard Credentials

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

CHANNEL-ID

string · required

Brick's channel id

Default: A0

Status for Dynamic QRIS › Request Body

originalReferenceNo

string

Unique identifier for the original transaction. e.g. QR_75ae1b56c40449ecbc42010e3d2589cc

Default: QR_75ae1b56c40449ecbc42010e3d2589cc

originalPartnerReferenceNo

string

Unique identifier for the original transaction assigned by the partner. e.g. 20241115000000189723

Default: 20241115000000189723

serviceCode

string

Must be set to '51'

Default: 51

Status for Dynamic QRIS › Responses

200

responseCode

string

responseMessage

string

originalReferenceNo

string

originalPartnerReferenceNo

string

serviceCode

string

latestTransactionStatus

string

transactionStatusDesc

string

object