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

Get Payment Url

Developing
POST
/direct-debit/core/v1/debit/payment-host-to-host
获取支付链接

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 格式: /direct-debit/core/v1/debit/payment-host-to-host
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
客户生成的唯一交易号
validUpTo
string 
required
支付自动过期的时间,时间戳或以 YYYY-MM-DDTHH:mm:ss+07:00 的格式。时间必须是 GMT+7(雅加达时间)
amount
object 
required
交易金额
currency
string 
required
货币类型
value
string 
required
交易净额。
如果是印尼盾(IDR),则值包含两位小数。
例如,IDR 10.000,- 将表示为 10000.00。
urlParams
array [object {2}] 
required
url参数
type
string 
required
url类型有两种:
PAY_RETURN代表支付成功之后跳转页面
NOTIFICATION代表支付结果回调的地址
这两个参数都需要传
url
string 
required
url
additionalInfo
object 
required
其他参数
channel
string 
required
渠道参数
EMONEY_DANA_SNAP
orderTitle
string 
optional
订单标题
subMerchantId
string 
optional
商户在三方申请的子商户id,设置此参数后,生成的支付链接点开后对应商户名称会展示这个子商户的名称
externalStoreId
string 
optional
也是申请后由银行提供,与subMerchantId一起使用来展示子商户名称
Example
{
  "partnerReferenceNo": "fd3f5af0-af57-4513-95a8-77df45721edw",
  "validUpTo": "1746249942",
  "amount": {
    "currency": "IDR",
    "value": "30.00"
  },
  "urlParams": [
    {
      "type": "PAY_RETURN",
      "url": "https://dev-payment.ayolinx.id/status?h=f13ce04d-34c5-4a03-ac46-d608cab468a2"
    },
    {
      "type": "NOTIFICATION",
      "url": "https://dev-payment.ayolinx.id/status?h=f13ce04d-34c5-4a03-ac46-d608cab468a2"
    }
  ],
  "additionalInfo": {
    "channel": "EMONEY_DANA_SNAP"
  }
}

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/direct-debit/core/v1/debit/payment-host-to-host' \
--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-77df45721edw",
    "validUpTo": "1746249942",
    "amount": {
        "currency": "IDR",
        "value":"30.00"
    },
    "urlParams":[
        {
            "type":"PAY_RETURN",
            "url":"https://dev-payment.ayolinx.id/status?h=f13ce04d-34c5-4a03-ac46-d608cab468a2"
        },
        {
            "type":"NOTIFICATION",
            "url":"https://dev-payment.ayolinx.id/status?h=f13ce04d-34c5-4a03-ac46-d608cab468a2"
        }
    ],
    "additionalInfo":{
        "channel":"EMONEY_DANA_SNAP"
    }
   
}'

Responses

🟢200Success
application/json
Body
responseCode
string 
required
responseMessage
string 
required
webRedirectUrl
string 
required
支付链接,三方跳转链接
partnerReferenceNo
string 
required
唯一交易ID
Example
{
  "responseCode": "2005400",
  "responseMessage": "Success",
  "webRedirectUrl": "https://m.sandbox.dana.id/m/portal/cashier/checkout?bizNo=20250110111212800110166288701912477&timestamp=1736479628052&originSourcePlatform=IPG&mid=216620020030015007074&sign=aRAz%2FmuDkP3bXBtjobQ7VRJIRjhjX352T4r4Ggq%2FBZVrhokXPw8f1urdleeNQe8if3TDD6yD%2FVTP%2FImqT%2BEVNQ3WatV1fdUYkZ6mTaI9%2B%2BKLEHzXZiziapD971C0Zopa1zogEFw2UfanfMeYSyngaDwozLTOf5zGVBNqtIozFZMU5twcnpLtbDTdYkGX%2FLgwzqh3dKGirPQD7MrEqJrpF%2Foi34uNStgpwQUx6%2BRVBB9fu5M%2Fp65D8QfCgyztzr7p5xgKouLsu5sz1QiqHRJoFpRCFenqnNUZgwV%2FSbOWsBiDJBBhoxjcMzUNCISJubrj4Gt6gURwODVnWzHO2SIa8g%3D%3D&forceToH5=false",
  "partnerReferenceNo": "fd3f5af0-af57-4513-95a8-77df45721edx"
}
Modified at 2025-03-07 11:04:31
Previous
Access Token B2B
Next
Inquiry Status