Characteristics #

Payment process #

1. The client chooses to pay with unionpay and is redirected to unionpay payment page

Server to Server integration #

Using unionpay, customers pay by redirecting from your website or app, finish the payment, then return to your website or app where you get immediate notification on whether the payment succeeds or fails.

Overview #

For direct API intergration, you can create payment intent and get url in only one step, the folllowing is the demo of creating payment intents:

1. Create a PaymentIntent

Create a PaymentIntent #

A PaymentIntent is an object that represents your intent to collect payment from your customer and tracks the lifecycle of the payment process. Create a PaymentIntent on your server and specify the amount to collect and a supported currency. If you have an existing Payment Intents integration, add unionpay to the list of payment method types.

Request Create a PaymentIntent

{
    "amount":1050,
    "currency":"CNY",
    "confirm":true,
    "payment_method_data" : {
        "type":"unionpay"
    },
    "return_url":"https://your.website"
}

Response

{
    "id": "pi_1646357082686881792",
    "object": "payment_intent",
    "created": 1681357091000,
    "currency": "CNY",
    "amount": 1050,
    "status": "requires_action",
    "livemode": true,
    "client_secret": "pi_1646357082686881792_secret_WrLaoJjPfB9FaWPfaqsxQyPx",
    "next_action": {
        "type": "unionpay_handle_redirect",
        "unionpay_handle_redirect": {
            "url": "https://api.wooshpay.com/v1/receives/paydibs/pay/1646357082686881792"
        }
    },
    "payment_method_types": [
        "grabpay",
        "mcash",
        "boost",
        "touchngo",
        "unionpay"
    ],
    "confirmation_method": "automatic",
    "return_url": "https://your.website",
    "payment_method": "pm_1646357082556858368",
    "capture_method": "automatic"
}