In-App Payment

[!TIP|style:flat] After payment is completed. Please refer to the Alipay plus document：https://docs.alipayplus.com/alipayplus/alipayplus/integration_cashier_acq/accept_payment#VZZUh

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.CreatePaymentsWechatMiniPay	Required
time	Long	timestamp	Required

Parameter

Parameter	Type	Description	Mark
pay_method	String	online	Required
sub_pay_method	String	Alipay	Required
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	the redirect URL after payment is completed	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：

"dde96284f01b59a956e762e757f12022ec9eec6d0b3c5a1fede12b8673259883"

Example Request:

{
    "user": "016683",
    "sign": "dde96284f01b59a956e762e757f12022ec9eec6d0b3c5a1fede12b8673259883",
    "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: For IOS ，For Android.

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.

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

In app payment