# 1. Create Authorization Url
# Request URL
{domain}/open-api/direct/debit/token/apply
# Request Method
- POST
# Request Headers
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Content-Type | Yes | string | application/json |
# Request Body Parameters
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| appId | Yes | string | Application APPID |
| param | Yes | string | Parameter body |
| sign | Yes | string | Signature |
# param
| Parameter Name | Required | Type | Length | Example | Description |
|---|---|---|---|---|---|
| timestamp | Yes | long | - | 1677495496979 | Current timestamp |
| userId | Yes | string | 1-32 | - | Merchant internal user id |
| requestId | Yes | string | 1-32 | CCP20220428011068111 | Merchant request id (unique for transactionId) 1-32 characters |
| channelCode | Yes | string | - | Reference list | Channel code |
| countryCode | Yes | string | - | - | Country code (PH, ID, MY, TH) |
| terminalType | Yes | string | - | - | terminal type (WEB, WAP) |
| osType | No | string | - | - | os type (IOS, ANDROID) require if terminalType is WAP |
| notifyUrl | Yes | string | 1-256 | - | Auth notification URL |
| redirectUrl | Yes | string | 1-512 | - | Redirect URL |
# Request Example
# Request Body
{
"appId":"b96f05030ffc411185c06f959e1c9210",
"sign":"MjlMdow07Ix0BFLIfLnm2PPdMK9t+yEyMSX4jkFxajdNcCRKu0P3N8BGQiKksY3xSmUR4Wr4k4+hBpzJGR6uEBFnn/LtqCxahJYbPfgJd5IwNlbA3kzG7JtNWImJDxM7mfAgfsnI+HnGMlASO5gDbtpX7FyypzxoBuYTDtvftsdJ2o7kj27yK0eqYbDNhL9WOAakq55l4kf8KCbplDOWbAZVKzR0+mHPeVrA5aOISImsiPHTOKFBgEEjI713Xu0k1fmze+oMMXYvwS010EvQUSkrWa12j4P7C6+XDD6cRi3KMdzxKGDr0oDUMBa39lG2Gd94A8o96w06h+kfAd7OgA==",
"param":"{\"requestId\":\"Joey0ub5yxzecu4c866ub100\",\"userId\":\"u0009\",\"channelCode\":\"PH_GCASH_DIRECT_DEBIT\",\"countryCode\":\"PH\",\"notifyUrl\":\"https://webhook.site/b89c5e5f-3056-438f-8329-b39ff5a181de\",\"redirectUrl\":\"https://kademo.intlalipay.cn/melitigo/Test_113.html\",\"terminalType\":\"WAP\",\"osType\":\"ANDROID\",\"timestamp\":1726139239}"
}
# Response Param
| Parameter Name | Type | Description |
|---|---|---|
| code | integer | response code |
| message | string | response message |
| data | Object | data |
# data
| Parameter Name | Type | Description |
|---|---|---|
| userId | string | Merchant internal user id |
| requestId | string | Merchant request id |
| channelCode | string | Channel Code |
| authUrl | string | Auth Url |
# Response Example
# Response Body
{
"code": 10000,
"message": "Success",
"data": {
"requestId": "Joey0ub5yxzecu4c866ub100",
"userId": "u0009",
"channelCode": "PH_GCASH_DIRECT_DEBIT",
"authUrl": "https://ac.alipay.com/page/sandbox/common-auth-pMiddle.html?acqSiteId=Z02TE1941000000A&clientId=TEST_305XSM222YRKG505&mcc=0000&merchantEngName=jtest064&merchantId=AliP202408122uexde&merchantName=jtest064&netAuthId=REQ534187030565883904&paySiteId=102217000000000000A&redirectUrl=https%3A%2F%2Fg.alipayplus.com%2Fpage%2Fac-auth-payment%2Fresult%2Fmobile%2Findex.html%3FloadMode%3D2%26callbackType%3DCommon%26terminalType%3DWAP%26referenceAgreementId%3DDBU534187030154842112%26authRequestId%3D2024091219091305000120000426810%26pspId%3D102217000000000000A%26clientId%3DTEST_305XSM222YRKG505&scopes=AGREEMENT_PAY&sellerEngName=jtest064&state=REQ534187030565883904&terminalType=WAP&signature=i5yYyCHuqgXopVeYCbCDdwK5po7cqrogyVC5%2FI726q1d73CpGAzqj2EyPAunMCdVFwNsP30v8OTQroPi8ieDD1UAKuFK5h7BVKBxmSZjlP2rSoOI3b1v3Z3T%2BNFgDkWzTfUyZ6ah97R1J540Ov1O%2BINuoR0ptcXFmRS%2BDFUknhG2LHtTfFHR0UhFBS3qqISRwHEnN8uf3t4zs6PzJvqLB1SuGJhVzYQF7xXiFiN0OiIWvphf5QdXai3E4sizE5GZfunyJCHDPoAOlfnlZATQzwAeexc8BTXBwsnSaMC5MRw4%2BGEAAz9DcFBTBCSZ5%2BLTzVILb9r4nqJ3YHGT47JnVQ%3D%3D"
}
}
# Failed Response Example
{
"code": 21000,
"message": "Server error, Please try again later.",
"data": null
}