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 Timeout (minutes) value 0-1440 Required
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&currency=EUR&description=YabandPay test&method=v3.CreatePaymentsAlipayAppPay&notify_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:
  1. On a successful API call, the response will be "status": true.

  2. 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
false -1000 Internal error
false -3001 Required field is missing
false -403 The signature Error
false -4011 Not support the payment method

results matching ""

    No results matching ""