> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Métodos de Pago en Corea del Sur

> Acepta billeteras locales coreanas PAYCO, Naver Pay y Kakao Pay junto con tarjetas locales coreanas y tarjetas internacionales, facturadas en KRW. Aprende sobre disponibilidad, soporte de suscripciones y configuración.

Los clientes de Corea del Sur prefieren fuertemente las billeteras locales y tarjetas nacionales sobre los métodos de pago internacionales. Dodo Payments soporta las principales billeteras coreanas — **PAYCO**, **Naver Pay**, y **Kakao Pay** — junto con **tarjetas locales coreanas** y tarjetas internacionales, todas facturadas en **KRW** (Won surcoreano).

## Por qué Importan los Métodos de Pago Coreanos

<CardGroup cols={3}>
  <Card title="Wallet-First Market" icon="wallet">
    Los compradores coreanos abrumadoramente finalizan sus compras con billeteras locales como Kakao Pay y Naver Pay en lugar de ingresar detalles de tarjeta.
  </Card>

  <Card title="Domestic Card Networks" icon="credit-card">
    Muchas tarjetas coreanas operan en redes locales. Soportar tarjetas locales coreanas evita rechazos en tarjetas que los sistemas internacionales no pueden procesar.
  </Card>

  <Card title="Higher Conversion" icon="chart-line">
    Ofrecer métodos locales familiares reduce la fricción y el abandono en la compra para los clientes en Corea del Sur.
  </Card>
</CardGroup>

## Métodos Soportados

| Método                           | Tipo                    | Suscripciones | Importe Mínimo |
| :------------------------------- | :---------------------- | :-----------: | :------------- |
| **Kakao Pay**                    | Billetera               |       Sí      | \~\$1.00       |
| **Naver Pay**                    | Billetera               |       Sí      | \~\$1.00       |
| **PAYCO**                        | Billetera               |       No      | \~\$1.00       |
| **Tarjetas Locales Coreanas**    | Tarjeta                 |       Sí      | \~\$1.00       |
| **Tarjetas de Crédito y Débito** | Tarjeta (internacional) |       Sí      | \~\$1.00       |

<Info>
  La disponibilidad de billeteras depende del tipo de transacción. **Kakao Pay** y **Naver Pay** se ofrecen para suscripciones, mientras que **PAYCO** se ofrece para pagos únicos. Todos requieren una moneda de facturación en **KRW**.
</Info>

## Configuración

### Tipos de Métodos API

| Tipo        | Descripción                                              |
| :---------- | :------------------------------------------------------- |
| `kakao_pay` | Billetera Kakao Pay                                      |
| `naver_pay` | Billetera Naver Pay                                      |
| `payco`     | Billetera PAYCO                                          |
| `credit`    | Tarjetas de crédito, incluidas tarjetas locales coreanas |
| `debit`     | Tarjetas de débito, incluidas tarjetas locales coreanas  |

### Ejemplo: Pago Enfocado en Corea del Sur

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: [
    'kakao_pay',
    'naver_pay',
    'payco',
    'credit',
    'debit'
  ],
  billing_currency: 'KRW',
  billing_address: {
    country: 'KR',
    zipcode: '06236'
  },
  return_url: 'https://example.com/success'
});
```

### Requisitos

Para que los métodos de pago coreanos aparezcan en el pago:

1. **País de facturación** es Corea del Sur (`KR`)
2. **Moneda** es KRW
3. Para comerciantes con precios en otra moneda: **Moneda Adaptativa** debe estar habilitada para que los clientes sean facturados en KRW

<Warning>
  Si tienes precios en otra moneda y Moneda Adaptativa no está habilitada, los clientes coreanos no serán facturados en KRW y las billeteras coreanas no estarán disponibles.
</Warning>

<Note>
  KRW es una moneda sin decimales: los importes se expresan en won enteros sin unidades menores. Envía y lee los montos en KRW como valores enteros en lugar de dividir por 100.
</Note>

## Mejores Prácticas

<AccordionGroup>
  <Accordion title="Offer wallets prominently">
    Para los clientes coreanos, las billeteras locales deben ser las opciones principales. Kakao Pay y Naver Pay son los métodos de pago más familiares para la mayoría de los compradores coreanos.
  </Accordion>

  <Accordion title="Include card fallbacks">
    Siempre incluye `credit` y `debit` para que los clientes sin una billetera preferida — y los clientes que pagan con tarjetas locales coreanas — aún puedan completar el pago.
  </Accordion>

  <Accordion title="Match currency to region">
    Los métodos de pago coreanos requieren KRW. Si tu catálogo tiene precios en otra moneda, habilita la Moneda Adaptativa para que a los clientes coreanos se les cotice y facture en KRW.
  </Accordion>

  <Accordion title="Choose wallets by transaction type">
    Usa Kakao Pay y Naver Pay para suscripciones y PAYCO para pagos únicos. Incluir los tres permite a Dodo presentar la opción correcta según el contexto del pago.
  </Accordion>
</AccordionGroup>

## Solución de Problemas

<AccordionGroup>
  <Accordion title="Korean wallets not appearing at checkout">
    **Verifica:**

    1. ¿País de facturación configurado a `KR`?
    2. ¿Moneda configurada a `KRW`?
    3. Si hay precios en otra moneda: ¿Moneda Adaptativa habilitada?
    4. ¿La billetera (`kakao_pay`, `naver_pay`, o `payco`) incluida en `allowed_payment_method_types`?

    **Solución:** Verifica que la dirección de facturación tenga `country: "KR"` e `billing_currency: "KRW"`.
  </Accordion>

  <Accordion title="Wallet missing for a subscription">
    **Causa:** PAYCO se ofrece solo para pagos únicos. Para facturación recurrente, usa Kakao Pay o Naver Pay.

    **Solución:** Incluye `kakao_pay` e `naver_pay` en `allowed_payment_method_types` para pagos de suscripción.
  </Accordion>

  <Accordion title="Korean card declined on the international network">
    **Causa:** Algunas tarjetas coreanas operan en redes locales que los sistemas internacionales no pueden procesar.

    **Solución:** Mantén `credit` e `debit` habilitadas para que las tarjetas locales coreanas se enruten correctamente.
  </Accordion>
</AccordionGroup>

## Páginas Relacionadas

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Ver todos los métodos de pago soportados.
  </Card>

  <Card title="Credit & Debit Cards" icon="credit-card" href="/features/payment-methods/cards">
    Redes de tarjetas, incluidas las tarjetas locales coreanas.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Facturar a los clientes en su moneda local, incluido KRW.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Datos de prueba y orientación sobre pruebas de pago.
  </Card>
</CardGroup>