Ayolinx-Openapi

Generate Qris

Developing

POST

/v1.0/qr/qr-mpm-generate

Request

Header Params

Content-Type

string

required

Example:

application/json

X-TIMESTAMP

string

required

Client's current local time in yyyy-MM-ddTHH:mm:ssXXX format

Example:

2024-09-12T12:55:00+07:00

X-SIGNATURE

string

required

The symmetric signature algorithm HMAC_SHA512(clientSecret, stringToSign) is used and converted to base64. stringToSign = "{method}:{EndpointUrl}:{token}:{hashedRequestBody}:{requestTimestamp}". hashedRequestBody = hash('sha256', json_encode(bodyData)). The format of EndpointUrl: /v1.0/qr/qr-mpm-generate

Example:

85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5

X-PARTNER-ID

string

required

Unique ID for a partner (Merchant Client ID).

Example:

CKSandbox-100dc9aa-f8ee-4a00-a933-6f4e8963b666

X-EXTERNAL-ID

string

required

Numeric string. Reference number that should be unique in the same day (request-id).

Example:

418075533589

Authorization

string

required

Bearer "access token" obtainedn from Get B2B Token API.

Example:

Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_ 3EPXdbqb45N4ciQ

Body Params application/json

partnerReferenceNo

string

required

The unique transaction number generated by the merchant

amount

object

required

Transaction amount

currency

string

required

Currency type

value

string

required

value

additionalInfo

object

required

channel

string

required

BNC_QRIS

subMerchantId

string

optional

Submerchant id applyed from merchant to bank(MID), if this param setted, the qr code will show the name of this submerchant

Example

{
  "partnerReferenceNo": "fd3f5af0-af57-4513-95a8-77df45721ed27",
  "amount": {
    "currency": "IDR",
    "value": "10001.00"
  },
  "additionalInfo": {
    "channel": "BNC_QRIS"
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://sandbox.dev.ayolinx.id:9080/v1.0/qr/qr-mpm-generate' \
--header 'X-TIMESTAMP: 2024-09-12T12:55:00+07:00' \
--header 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \
--header 'X-PARTNER-ID: CKSandbox-100dc9aa-f8ee-4a00-a933-6f4e8963b666' \
--header 'X-EXTERNAL-ID: 418075533589' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_ 3EPXdbqb45N4ciQ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "partnerReferenceNo":"fd3f5af0-af57-4513-95a8-77df45721ed27",
    "amount": {
        "currency": "IDR",
        "value":"10001.00"
    },
    "additionalInfo":{
        "channel":"BNC_QRIS"
    }
}'

Responses

🟢200Success

application/json

Body

responseCode

string

required

responseMessage

string

required

qrContent

string

required

The payment QR code string in QRIS format

qrUrl

string

required

Qr url

partnerReferenceNo

string

required

Transaction identifier on service customer system

expiredDate

string

required

The QR expire time, seconds timestamp

Example

{
  "responseCode": "2004700",
  "responseMessage": "Success",
  "qrContent": "00020101021226740025ID.CO.BANKNEOCOMMERCE.WWW011893600490591008046002120005200006120303URE51550025ID.CO.BANKNEOCOMMERCE.WWW0215BNC2311131767850303URE5204152053033605405100015502015802ID5913Ayolinx_Name26014TIMOR TENG SEL6105855626233012230018776426787160514570703A016304987E",
  "qrUrl": "https://sit-marketing-img.bankneo.co.id/qris/merchant/img/m3SDrRUVNlbV4mkxEhOZylEypAQn2HNWSA5W0UO1tEc.png",
  "expiredDate": "1741332294",
  "partnerReferenceNo": "fd3f5af0-af57-4513-95a8-77df45721ed26"
}

Modified at 2025-03-10 07:53:49

Access Token B2B

Query Qris