Desktop Website Browser - Korean Local Cards

Accept Korean Local Cards payments on your website by redirecting the shopper to the Korean Local Cards page.

Step 1. Initialize a Payment Intent

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

POST /api/v1/pa/payment_intents/create

JSON
1{ 
2  "request_id": "ed11e38a-7234-11ea-aa94-7fd44ffd1b89",
3  "amount": 1000,
4  "currency": "KRW",
5  "merchant_order_id": "85d7b0e0-7235-11ea-862e-9f6aa1adfca6",
6  "return_url": "https://www.airwallex.com"
7}

Step 2. Redirect the shopper to the Korean Local Cards page

When a shopper selects to pay with Korean cards on their desktop browser, call the Confirm a Payment Intent API API to get a payment URL pointing to the Korean Local Cards page.

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

JSON
1{
2  "request_id": "ed11e38a-7234-11ea-aa94-7fd44ffd1b89",
3  "payment_method": {
4    "type": "korean_local_card"
5  }
6}

You will get a response similar to the following.

JSON
1{
2  // ... other fields omitted.
3  "next_action": {
4    "type": "redirect",
5    "method": "GET",
6    "url": "https://api.airwallex.com/pa/redirect/hk/hkpdsdw5rgsyzaahhfr_9vtjfa?checksum=d4519b54d364"
7  }
8}

You should redirect the shopper to the Korean Local Cards page with the next_action.url returned in the confirm Payment Intent response.

Once generated, the URL will expire in 30 minutes. Confirming the Payment Intent again with Korean Local Cards or other payment methods will lead to the invalidation of the URL.

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, 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.