Attributes
- METHOD TYPEE-wallet
- PAYMENTS
- PAYOUTS
- REFUNDS
- RECURRING
Introduction
KakaoPay is a payment method in South Korea for payments and refunds. It is specialized for e-commerce.
Supported Countries
- South Korea
Supported Currencies
- KRW
Payment (Deposit) Flow
Follow these steps to perform a payment using Nuvei REST API integration:
1. Generate a sessionToken
Press here for details.
2. Send a /payment
Request
Perform the payment by sending a /payment
request with its mandatory parameters including:
userTokenId
amount
currency
paymentOption.alternativePaymentMethod
block containing:paymentMethod
: “apmgw_KaKaoPay“
deviceDetails
block containing:ipAddress
billingAddress
block containing:firstName
,lastName
,email
,phone
,country
userDetails
block containing:firstName
,lastName
,email
,phone
,country
Example /payment
Request
{ "sessionToken":"<sessionToken from /getSessionToken>", "merchantId":"<your merchantId>", "merchantSiteId":"<your merchantSiteId>", "clientRequestId":"<unique request ID in merchant system>", "amount":"1000", "currency":"KRW", "userTokenId":"<unique customer identifier in merchant system>", "clientUniqueId":"<unique transaction ID in merchant system>", "paymentOption":{ "alternativePaymentMethod":{ "paymentMethod":"apmgw_KaKaoPay" } }, "deviceDetails":{ "ipAddress":"<customer's IP address>" }, "billingAddress":{ "firstName":"John", "lastName":"Smith", "phone":"825432530847", "email":"[email protected]", "country":"KR" }, "userDetails":{ "firstName":"John", "lastName":"Smith", "phone":"825432530847", "email":"[email protected]", "country":"KR" }, "timeStamp":"<YYYYMMDDHHmmss>", "checksum":"<calculated checksum>" }
After the transaction is processed, Nuvei sends a Direct Merchant Notification (DMN) that includes the result of the transaction to the URL provided in urlDetails.notificationUrl
, which Nuvei recommends including in the /payment
request.
User Experience
- The user is redirected to the KakaoPay website.
- The user scans a QR code using the KakaoPay app.
- The user confirms the payment using biometric verification or their 6-digit PIN.
The user sees the payment details and a message confirmation of the payment.
- The user confirms the payment and is redirected to the merchant
ReturnUrl
.