YabandPay Payment Gateway Integration Guide

Suprith · June 7, 2025, 2:34pm

This guide helps you integrate YabandPay into your system for creating payments and processing refunds using various digital wallets like Google Pay, WeChat Pay, PayPal and Alipay.

Supported Regions

YabandPay primarily supports merchants operating in Europe, with a focus on processing payments in EUR and CNY currencies. It is ideal for businesses targeting international consumers who prefer digital wallets, especially those in China and Europe.

Setup Requirements

Before starting, ensure you have:

Your User and secret key provided by YabandPay.

API Overview

API URL: https://mapi.yabandpay.com/Payments

Method: POST

POST data type: JSON

Request Parameters

Parameter	Type	Description	Required
user	String	The UID of cashier account	Required
sign	String	Signature	Required
method	String	v3.CreatePayments	Required
time	Long	Timestamp	Required

Data Parameters

Parameter	Type	Description	Required
pay_method	String	online	Required
sub_pay_method	String	PayPal	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 CNY 1	Required
currency	String	EUR	Required
description	String	Order description	Required
demo	String	Custom field	Optional
iDeal_email	String	Request email from customer	Optional
timeout	String	Value 0 means 1440 minutes	Optional
redirect_url	String	The redirect URL after payment is completed	Optional
notify_url	String	Asynchronous notification URL	Required

Note: Data parameters and method vary based on the type of payment method you want to integrate. Check the official API documentation for complete details.

Signature

Lexicographical sequence and URL key-value format new string:

amount=0.1&currency=EUR&description=YabandPay test&method=v3.CreatePayments&notify_url=https://www.yabandpay.com&order_id=202506041018&pay_method=online&redirect_url=&sub_pay_method=PayPal&time=1546588959&timeout=0&user=016683

Use stringA and secret_key to get stringSign

Get Signature:

4e65042e51b045e4430a2fd9f13a4c0232d4a1bcca2a664191735b910b18e899

Example Request

{
    "user": "016683",
    "sign": "a1e558698ab3e1b1b221f8e8bf149e4128f82185052443286e14dbcf5c2f3c63",
    "method": "v3.CreatePayments",
    "time": 1546588959,
    "data": {
        "description": "YabandPay test",
        "timeout": "0",
        "pay_method": "online",
        "sub_pay_method": "PayPal",
        "order_id": "20250604888",
        "amount": "0.1",
        "currency": "EUR",
        "redirect_url": "https://www.yabandpay.com",
        "notify_url": "https://www.yabandpay.com/notify"
    }
}

Example Response

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "20250604888",
        "trade_id": "0de7b730-4495-0c22-109a-814261b136ed",
        "amount": "0.10",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/pay_method/cGF5cGFs/MGRlN2I3MzAtNDQ5NS0wYzIyLTEwOWEtODE0MjYxYjEzNmVk",
        "state": "processing"
    },
    "message": ""
}

Payment URL Handling

The url field in the API response is a hosted payment page link provided by YabandPay. Redirect your customer to this URL to let them complete the payment.

After a successful or failed attempt, the user will be redirected to the redirect_url you provided. YabandPay will also send an asynchronous status update to your notify_url.

PayPal Online

TIP

For the convenience of integration, PayPal is implemented in a managed manner. Merchants are required to register with PayPal. After completing the account registration, please submit the following parameters to YabandPay:
Client ID, Client Secret, and Webhook ID. YabandPay will securely manage the accounts, and the funds will flow directly to the corresponding accounts without passing through YabandPay.

Refund

For a period after a payment transaction has been completed and a refund is required by either the Payer or Merchant, the Merchant can refund the Payer via this API. After the YabandPay receives and verifies the refund request successfully, the Payer will be refunded with the request refund amount (less than or equal to the original payment amount) according to the refund rules.

Important Notes

For any transaction completed more than one year prior, a refund is not supported
A refund for a transaction can be processed in the form of multiple partial refunds. In this case, the original order number is required. The total refund amount cannot exceed the original payment amount
Partial refund for one order should be less than 30 times

API Details