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
        • Query Qris
        • Cancel Qris
      • 需要商户提供的非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
          POST
        • retail query
          POST
      • 需要商户提供的回调地址 Copy
        • Payment Notify
  1. Ayolinx提供给商户的接口

Create retail transaction

Developing
POST
/v1.0/retail/create

Request

Header Params
Content-Type
string 
optional
Example:
application/json
X-TIMESTAMP
string 
optional
Example:
2024-09-12T12:55:00+07:00
X-SIGNATURE
string 
optional
Example:
85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-PARTNER-ID
string 
optional
Example:
CK-11111abc-0000-2222-bbcc-dd55555ee666
X-EXTERNAL-ID
string 
optional
Example:
418075533589
Authorization
string 
optional
Example:
Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_ 3EPXdbqb45N4ciQ
Body Params application/json
partnerReferenceNo
string 
required
商户唯一交易号
validUpTo
string 
required
支付自动过期的时间,以 YYYY-MM-DDTHH:mm:ss+07:00 的格式。时间必须是 GMT+7(雅加达时间)
customerName
string 
required
客户名字
customerEmail
string 
required
客户邮箱
customerPhone
string 
optional
客户手机号
amount
object 
required
金额
currency
string 
required
单位
value
string 
required
金额
urlParams
array [object {2}] 
optional
地址
url
string 
required
type
string 
required
url类型有两种:
PAY_RETURN代表支付成功之后跳转页面
NOTIFICATION代表支付结果回调的地址
additionalInfo
object 
required
channel
string 
required
渠道支持
RETAIL_ALFAMART
RETAIL_PEGADAIAN
RETAIL_POS_INDONESIA
RETAIL_ALFAMIDI
RETAIL_DANDAN
Example
{
    "partnerReferenceNo": "string",
    "validUpTo": "string",
    "customerName": "string",
    "customerEmail": "string",
    "customerPhone": "string",
    "amount": {
        "currency": "string",
        "value": "string"
    },
    "urlParams": [
        {
            "url": "string",
            "type": "string"
        }
    ],
    "additionalInfo": {
        "channel": "string"
    }
}

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/retail/create' \
--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": "string",
    "validUpTo": "string",
    "customerName": "string",
    "customerEmail": "string",
    "customerPhone": "string",
    "amount": {
        "currency": "string",
        "value": "string"
    },
    "urlParams": [
        {
            "url": "string",
            "type": "string"
        }
    ],
    "additionalInfo": {
        "channel": "string"
    }
}'

Responses

🟢200Success
application/json
Body
responseCode
string 
required
responseMessage
string 
required
partnerReferenceNo
string 
required
商户交易号
expiryDate
string 
required
过期时间
vaNumber
string 
required
va号码
paymentUrl
string 
required
支付说明链接
Example
{
    "responseCode": "00",
    "responseMessage": "Successful",
    "partnerReferenceNo": "ei29dh29ee233UE383hf29hr",
    "expiryDate": "2024-09-12T12:55:00+07:00",
    "vaNumber": "021113791978",
    "paymentUrl": "https://passport.duitku.com/topup/topupdirectv2.aspx?ref=FT25ONEXEAPGG3C043O"
}
Previous
Payment Notify
Next
retail query