In-App Payment
API URL:https://mapi.yabandpay.com/Payments
Method:POST
POST data type:Json
Parameter | Type | Description | Mark |
---|---|---|---|
user | String | the UID of cashier account | Required |
sign | String | signature | Required |
method | String | v3.CreatePaymentsAlipayAppPay | Required |
time | Long | timestamp | Required |
- Parameter
Parameter | Type | Description | Mark |
---|---|---|---|
pay_method | String | online | Required |
sub_pay_method | String | Alipay | Required |
sub_pay_method_type | String | Reference List of Supported Wallets | Optional |
order_id | String | order id from Merchant | Required |
amount | String | format in cents: € 24.99 should be 24.99, the min amount is EUR 0.10 or CNY1 | Required |
currency | String | ISO 4217, For example EUR, CHF | Required |
demo | String | custom field | Optional |
timeout | String | value 0 means 1440 minutes | Optional |
notify_url | String | synchronous notification url | Required |
redirect_url | String | Payment completion redirect URL; Note for iOS and Android: For callbacks handled by the app, applink or deeplink must be used for callback processing. | Optional |
os_type | String | android or ios | Required |
Signature:
Lexicographical sequence and URL key-value format new string
"amount=1¤cy=EUR&description=YabandPay test&method=v3.CreatePaymentsAlipayAppPay¬ify_url=https://www.yabandpay.com/notify&order_id=202412654894165484&os_type=ios&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&sub_pay_method=Alipay&time=1546588959&timeout=0&user=016683"
Use stringA and secret_key to get stringSign
Get Signature:
"792a5996611d17e8d6efe0e1f05b8a94a1ed9aaadd050f8559bc998d55565276"
Example Request:
{
"user": "016683",
"sign": "792a5996611d17e8d6efe0e1f05b8a94a1ed9aaadd050f8559bc998d55565276",
"method": "v3.CreatePaymentsAlipayAppPay",
"time": 1546588959,
"data": {
"description": "YabandPay test",
"timeout": "0",
"pay_method": "online",
"sub_pay_method": "Alipay",
"order_id": "202412654894165484",
"amount": "1",
"currency": "EUR",
"notify_url": "https://www.yabandpay.com/notify",
"redirect_url": "https://www.yabandpay.com/redirect_url",
"os_type": "ios"
}
}
Example Response:
{
"status": true,
"code": "200",
"data": {
"order_id": "2024051614252298405",
"trade_id": "e5baf40b-08b2-4660-ed20-d632eeeceab3",
"amount": "0.01",
"currency": "EUR",
"settlement_amount": "0.01",
"settlement_currency": "EUR",
"exchange_rate": "1",
"parameters": {
"pay_url": "https://open-sea-global.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040097PyqF6IxZEzTURq7PhvTv3ken",
"payments_data": "{\"displayPaymentAmount\":\"0.01\",\"displayPaymentCurrency\":\"EUR\",\"wallets\":[{\"enabled\":true,\"promoNames\":[\"{\\\"en_US\\\":\\\"test\\\",\\\"nl_NL\\\":\\\"test\\\"}\"],\"searchKeywords\":[\"dana wallet\"],\"walletName\":\"DANA\"}]}"
},
"state": "processing"
},
"message": ""
}
More Information:
If your app uses webview mode, please redirect to pay_url. If your app is developed for IOS and Android, please download the SDK: Download.
Please refer to the official documentation of AliPay+ for integration.
Return results:
On a successful API call, the response will be
"status": true
.On a failed API call, the response will be
"status": false
.
We strongly recommend using both Order Query and Asynchronous Notification simultaneously to synchronize and update payment status, ensuring real-time accuracy of payment information.
List of Wallets Supported by Alipay+:
The wallet list corresponding to the sub_pay_method_type supports the following payment scenarios:
sub_pay_method_type | APP | WAP | Web | Mini Program |
---|---|---|---|---|
ALIPAY_CN | ✅ | ❌ | ✅ | ✅ |
TRUEMONEY | ✅ | ❌ | ✅ | ✅ |
ALIPAY_HK | ✅ | ✅ | ✅ | ✅ |
TNG | ✅ | ✅ | ✅ | ✅ |
GCASH | ✅ | ✅ | ✅ | ✅ |
DANA | ✅ | ✅ | ✅ | ✅ |
KAKAOPAY | ✅ | ❌ | ✅ | ❌ |
RABBIT_LINE_PAY | ✅ | ❌ | ✅ | ❌ |
BPI | ❌ | ✅ | ✅ | ❌ |
BOOST | ✅ | ✅ | ✅ | ❌ |
AKULAKU_PAYLATER | ✅ | ✅ | ✅ | ❌ |
BILLEASE | ✅ | ✅ | ✅ | ❌ |
TINABA | ✅ | ✅ | ✅ | ❌ |
NAVERPAY | ❌ | ✅ | ✅ | ❌ |
TOSSPAY | ✅ | ❌ | ✅ | ✅ |
MPAY | ✅ | ✅ | ✅ | ❌ |
KREDIVO_ID | ✅ | ❌ | ✅ | ❌ |
KPLUS | ✅ | ✅ | ✅ | ❌ |
HIPAY | ✅ | ✅ | ✅ | ✅ |
Result/Error codes:
Status | Code | Message |
---|---|---|
true | 200 | Success |
fales | -1000 | Internal error |
fales | -3001 | Required field is missing |
fales | -403 | The signature Error |
fales | -4011 | Not support the payment method |