Ayolinx-Openapi

Generate Qris

Developing

POST

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

生成支付Qris

Request

Header Params

Content-Type

string

required

Example:

application/json

X-TIMESTAMP

string

required

客户端当地时间，格式为yyyy-MM-ddTHH:mm:ssXXX

Example:

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

X-SIGNATURE

string

required

使用对称签名算法 HMAC_SHA512(clientSecret, stringToSign) 并且转换成 base64.stringToSign = "{method}:{EndpointUrl}:{token}:{hashedRequestBody}:{requestTimestamp}".hashedRequestBody = hash('sha256', json_encode($bodyData)).EndpointUrl 格式: /v1.0/qr/qr-mpm-generate

Example:

85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5

X-PARTNER-ID

string

required

商户ID，注册商户生成的唯一ID字符串

Example:

CK-11111abc-0000-2222-bbcc-dd55555ee666

X-EXTERNAL-ID

string

required

字符串，每次请求生成唯一的request-id字符串

Example:

418075533589

Authorization

string

required

Bearer "access token" ，从 Get B2B Token API获取

Example:

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

Body Params application/json

partnerReferenceNo

string

required

商户生成的唯一交易号

amount

object

required

交易金额

currency

string

required

货币类型

value

string

required

交易净额。
如果是印尼盾（IDR），则值包含两位小数。
例如，IDR 10.000,- 将表示为 10000.00。

additionalInfo

object

required

其他信息

channel

string

required

渠道号，取值示例：BNC_QRIS，详见渠道说明

subMerchantId

string

optional

商户在三方申请的子商户id(MID)，设置此参数后，生成的QR会展示对应子商户名称

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: CK-11111abc-0000-2222-bbcc-dd55555ee666' \
--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

QRIS格式的支付二维码字符串

qrUrl

string

required

二维码url地址

partnerReferenceNo

string

required

唯一交易号

expiredDate

string

required

二维码的失效时间，秒级时间戳格式

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-13 06:07:06

Payment Notify

Query Qris