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 class containing:
  • paymentMethod: “apmgw_KaKaoPay“
• deviceDetails class containing: ipAddress
• billingAddress class containing: firstName, lastName, email, phone, country
• userDetails class 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

1. The user is redirected to the KakaoPay website.
2. The user scans a QR code using the KakaoPay app.
   
3. 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.
   
4. The user confirms the payment and is redirected to the merchant ReturnUrl.