Ayolinx-Openapi
🇨🇳中文
  • 🇬🇧English
  • 🇨🇳中文
  1. Ayolinx提供给商户的接口
Ayolinx-Openapi
🇨🇳中文
  • 🇬🇧English
  • 🇨🇳中文
  • Openapi-ZH-CN
    • 开发须知
      • 简介
      • Header参数说明
      • 渠道说明
      • 回调说明
      • 错误码说明
      • 必要参数配置
      • Signature生成规则
      • PartnerServiceId说明
    • GetAccessToken
      • Access Token B2B
    • EWallet
      • Ayolinx提供给商户的接口
        • Get Payment Url
        • Inquiry Status
      • 需要商户提供的回调地址
        • Payment Notify
    • Qris
      • Ayolinx提供给商户的接口
        • Generate Qris
          POST
        • Query Qris
          POST
        • Cancel Qris
          POST
      • 需要商户提供的非snap回调地址
        • Payment Notify
      • 商户提供的snap回调地址
        • Access Token B2B
        • Payment Notify
    • VirtualAccount
      • 时序图
      • Ayolinx提供给商户的接口
        • Error Codes
        • Create VA
        • Inquiry Va
      • 需要商户提供的接口
        • 回调说明
        • Access Token B2B
        • Payment
      • 非snap回调接口
        • Payment Notify
    • Convenience Store
      • Ayolinx提供给商户的接口
        • Create retail transaction
        • retail query
      • 需要商户提供的回调地址 Copy
        • Payment Notify
  1. Ayolinx提供给商户的接口

Generate Qris

POST
/v1.0/qr/qr-mpm-generate
生成支付Qris

Request

Header Params
Content-Type
string 
required
Example:
application/json
X-TIMESTAMP
string 
required
参考 Header参数说明
Example:
2024-09-12T12:55:00+07:00
X-SIGNATURE
string 
required
参考 Header参数说明
Example:
85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-PARTNER-ID
string 
required
参考 Header参数说明
Example:
CK-11111abc-0000-2222-bbcc-dd55555ee666
X-EXTERNAL-ID
string 
required
参考 Header参数说明
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会展示对应子商户名称
urlParams
array [object {2}] 
optional
回调地址,可以上传,也可以商户后台配置
type
string 
required
NOTIFICATION
url
string 
required
回调地址
Example
{
    "partnerReferenceNo":"fd3f5af0-af57-4513-95a8-77df45721ed27",
    "amount": {
        "currency": "IDR",
        "value":"10001.00"
    },
    "additionalInfo":{
        "channel":"BNC_QRIS"
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox.ayolinx.id/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-06-20 09:35:42
Previous
Payment Notify
Next
Query Qris