Ayolinx-Openapi
🇬🇧English
  • 🇬🇧English
  • 🇨🇳中文
  1. APIS Ayolinx Provided to Merchant
Ayolinx-Openapi
🇬🇧English
  • 🇬🇧English
  • 🇨🇳中文
  • Openapi-EN-US
    • Read before development
      • Introduction
      • Header Parameter Description
      • Signature generation rules
      • Channel description
      • Error code description
      • Callback description
      • PartnerServiceId description
    • GetAccessToken
      • Access Token B2B
    • Qris
      • APIS Ayolinx Provided to Merchant
        • Generate Qris
          POST
        • Query Qris
          POST
        • Cancel Qris
          POST
      • APIS Need Merchant to Provide
        • Payment Notify
    • EWallet
      • APIS Ayolinx Provided to Merchant
        • Get Payment Url
        • Inquiry Status
      • APIS Need Merchant to Provid
        • Payment Notify
    • VirtualAccount
      • APIS Ayolinx Provided To Merchant
        • Error Codes
        • Create VA
        • Inquiry Va
      • APIS Need Merchant To Provide
        • Callback introduction
        • Access Token B2B
        • Payment
      • Non-snap callback interface
        • Payment Notify
  1. APIS Ayolinx Provided to Merchant

Query Qris

Developing
POST
/v1.0/qr/qr-mpm-query

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-query
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
originalPartnerReferenceNo
string 
required
transaction code generated by merchant
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: 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 '{
    "originalPartnerReferenceNo":"fd3f5af0-af57-4513-95a8-77df45721ed25",
    "additionalInfo":{
        "channel":"BNC_QRIS"
    }
}'

Responses

🟢200Success
application/json
Body
responseCode
string 
required
responseMessage
string 
required
originalReferenceNo
string 
required
The transaction number generated by Ayolinx
originalPartnerReferenceNo
string 
required
transaction code generated by merchant
amount
object 
required
amount
currency
string 
required
Currency
value
string 
required
Net amount of the transaction.
latestTransactionStatus
string 
required
Transaction status code [value]
finishedTime
string 
required
transaction finished time
additionalInfo
object 
required
channel
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-04-02 05:05:34
Previous
Generate Qris
Next
Cancel Qris