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
      • 需要商户提供的回调地址
        • Payment Notify
    • VirtualAccount
      • Ayolinx提供给商户的接口
        • Error Codes
        • Create VA
        • Inquiry Va
      • 需要商户提供的接口
        • 回调说明
        • Access Token B2B
        • Payment
      • 非snap回调接口
        • Payment Notify
  1. Ayolinx提供给商户的接口

Query Qris

Developing
POST
/v1.0/qr/qr-mpm-query
支付结果主动查询

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-query
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
originalPartnerReferenceNo
string 
required
商户生成的唯一交易号
additionalInfo
object 
required
channel
string 
required
BNC_QRIS
Example
{
  "originalPartnerReferenceNo": "fd3f5af0-af57-4513-95a8-77df45721ed25",
  "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 'http://sandbox.dev.ayolinx.id:9080/v1.0/qr/qr-mpm-query' \
--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 '{
    "originalPartnerReferenceNo":"fd3f5af0-af57-4513-95a8-77df45721ed25",
    "additionalInfo":{
        "channel":"BNC_QRIS"
    }
}'

Responses

🟢200Success
application/json
Body
responseCode
string 
required
responseMessage
string 
required
originalReferenceNo
string 
required
ayolinx生成交易号
originalPartnerReferenceNo
string 
required
商户传的唯一交易号
amount
object 
required
交易金额
currency
string 
required
货币类型
value
string 
required
交易净额。
如果是印尼盾(IDR),则值包含两位小数。
例如,IDR 10.000,- 将表示为 10000.00。
latestTransactionStatus
string 
required
交易状态的类别代码。其值包括
finishedTime
string 
required
交易完成时间
additionalInfo
object 
required
其他信息
channel
string 
required
traceId
string 
required
Example
{
  "responseCode": "2005100",
  "responseMessage": "Successful",
  "originalReferenceNo": "c91d75e02d624e93a13d79f5d40af221",
  "originalPartnerReferenceNo": "stella90",
  "amount": {
    "currency": "IDR",
    "value": "1000.00"
  },
  "latestTransactionStatus": "00",
  "finishedTime": "2025-03-27T06:40:39+00:00",
  "additionalInfo": {
    "channel": "BNC_QRIS"
  }
}
Modified at 2025-01-23 03:17:58
Previous
Generate Qris
Next
Cancel Qris