Part of Ant Financial OSP, Kakao Pay is a digital wallet within Kakao Talk, South Korea's most downloaded app in the Apple and Google Play store. Kakao Pay lets users safely make cashless payments for everyday usage, whether online or in-store. It also offers users the option to manage their investments, and cross border P2P mobile remittance in-app

Features

Processing currencies	KRW,GBP,USD,EUR
Settlement currencies	GBP,USD,EUR,HKD
Minimum transaction amount	1 KRW
Maximum transaction amount	2,000,000 KRW
Refunds	✅
Partial Refunds	✅
Multiple partial refund	❌
Chargeback	❌

Integration Method

Payment method enumeration values: kakaopay

There is integration method for Kakao Pay

1. Direct API

Direct API

How to integration

For direct API integration, you can create a PaymentIntent and get url in only one step. The following is the demo of creating payment intent:

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 kakaopay to the list of payment method types.

The enumeration values for terminal_type are WAP, WEB, APP, and MINI_APP:

WEB: indicates that a PC browser is used.

WAP: indicates that a mobile browser is used.

APP: indicates that a mobile app is used.

MINI_APP: indicates that a mini program is used.

os_type is required if terminal_type is "APP" or "WAP". The enumeration values for os_type areIOS 、 ANDROID 。

Request

{
    "amount":200,
    "currency":"KRW",
    "confirm":true,
    "payment_method_options":{
        "kakaopay":{
            "terminal_type":"APP",
            "os_type": "IOS"
        }
    },
    "payment_method_data" : {
        "type":"kakaopay"
    },
    "return_url":"https://wooshpay.com"
}

Response

{
    "id": "pi_1704776286032887808",
    "object": "payment_intent",
    "created": 1695285314000,
    "livemode": false,
    "currency": "KRW",
    "amount": 200,
    "status": "requires_action",
    "client_secret": "pi_1704776286032887808_secret_aHmBseB8L0F00LckjwWtPvIy",
    "next_action": {
        "type": "kakaopay_handle_redirect",
        "kakaopay_handle_redirect": {
            "url": "https://psp.ac.alipay.com/page/simulation-wallet/acwallet/alipayconnectcode.html?code=2816660400930nTo2sfoFzTldC2sffyv4qWK&pspName=KAKAOPAY&loadMode=2"
        }
    },
    "payment_method_types": [
        "kakaopay"
    ],
    "confirmation_method": "automatic",
    "payment_method_options": {
        "kakaopay": {
            "terminal_type": "APP",
            "os_type": "IOS"
        }
    },
    "return_url": "https://wooshpay.com",
    "payment_method": "pm_1704776285928030208",
    "capture_method": "automatic"
}

Next step

You can add more features to your integration as needed

Create a Webhook

Listen to events on your WooshPay account so your integration can automatically trigger reactions. Create a webhook that mainly focuses on enabled_events and url.

Create a Refund

Create a refund to repay funds to your customer. You can also perform partial refunds, but not every payment method supports them. A partial refund is when you refund only part of the original transaction amount.