Search...
APIJSLog inGet started
Airwallex logo
Home
Platform APIs
Connected Accounts
Accounts
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewChoose your payments solutionGet started with payments
Supported currencies
Online payments
Invoice integrations
Payment methods
Payment Methods OverviewGlobal
CardsAirwallex Pay
Apple Pay
Google Pay™
Klarna
Afterpay / Clearpay
PayPal
Desktop/Mobile Website Browser - PayPal
Skrill
EU & UK
APAC
North America & LATAM
Tax filing

Desktop/Mobile Website Browser - PayPal

Accept PayPal payments on your website by redirecting the shopper to PayPal.

Step 1. Initialize a Payment Intent

Create a Payment Intent with the Create a Payment Intent API API.

POST /api/v1/pa/payment_intents/create

JSON

Step 2. Redirect to PayPal to complete payment

When a shopper selects to pay with PayPal on their desktop/mobile browser, call the Confirm a Payment Intent API API to get a redirect URL.

POST /api/v1/pa/payment_intents/{id}/confirm

JSON

Note that shopper_name and country_code are optional for Managed Path (US) merchants.

You will get a response similar to the following.

JSON

You should redirect the shopper to the PayPal page with the next_action.url returned in the confirm Payment Intent response. The shopper will complete the payment on that page.

Step 3. Query the payment result status

To get the payment result, we suggest you poll the status of the Payment Intent via the Retrieve a Payment Intent API API. You may start polling the Payment Intent status after the shopper is redirected back to your website or mobile app, i.e., the return_url passed when creating the Payment Intent.

GET /api/v1/pa/payment_intents/{id}

In addition, Airwallex will notify you of the payment result asynchronously via the webhooks. Please refer to the webhook documentation to set up your webhook accordingly. Although subscribing to webhook events is optional, it is recommended to subscribe to the payment_intent.succeeded webhook which indicates that the shopper has paid the order.