Pular para o conteúdo principal
Os clientes sul-coreanos preferem fortemente carteiras locais e cartões domésticos em vez de métodos de pagamento internacionais. A Dodo Payments suporta as principais carteiras coreanas — PAYCO, Naver Pay e Kakao Pay — juntamente com cartões locais coreanos e cartões internacionais, todos faturados em KRW (Won sul-coreano).

Por que os Métodos de Pagamento Coreanos Importam

Wallet-First Market

Os compradores coreanos geralmente optam por carteiras locais como Kakao Pay e Naver Pay em vez de inserir detalhes do cartão.

Domestic Card Networks

Muitos cartões coreanos operam em redes locais. Apoiar cartões locais coreanos evita recusas em cartões que as redes internacionais não podem processar.

Higher Conversion

Oferecer métodos locais familiares reduz o atrito no checkout e o abandono para clientes na Coreia do Sul.

Métodos Suportados

MétodoTipoAssinaturasQuantia Mínima
Kakao PayCarteiraSim~$1.00
Naver PayCarteiraSim~$1.00
PAYCOCarteiraNão~$1.00
Cartões Locais CoreanosCartãoSim~$1.00
Cartões de Crédito & DébitoCartão (internacional)Sim~$1.00
A disponibilidade das carteiras depende do tipo de transação. Kakao Pay e Naver Pay são oferecidos para assinaturas, enquanto PAYCO é oferecido para pagamentos únicos. Todos requerem a moeda de faturamento em KRW.

Configuração

Tipos de Método API

TipoDescrição
kakao_payCarteira Kakao Pay
naver_payCarteira Naver Pay
paycoCarteira PAYCO
creditCartões de crédito, incluindo cartões locais coreanos
debitCartões de débito, incluindo cartões locais coreanos

Exemplo: Checkout Focado na Coreia do Sul

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 os métodos de pagamento coreanos aparecerem no checkout:
  1. O país de faturamento é a Coreia do Sul (KR)
  2. A moeda é KRW
  3. Para comerciantes precificados em outra moeda: Moeda Adaptativa deve estar habilitada para que os clientes sejam cobrados em KRW
Se você definir preços em outra moeda e a Moeda Adaptativa não estiver habilitada, os clientes coreanos não serão cobrados em KRW, e as carteiras coreanas não estarão disponíveis.
KRW é uma moeda sem casa decimal — os valores são expressos em won inteiros sem unidades menores. Envie e leia os valores de KRW como valores de número inteiro em vez de dividir por 100.

Melhores Práticas

Para clientes coreanos, carteiras locais devem ser as opções principais. Kakao Pay e Naver Pay são os métodos de checkout mais familiares para a maioria dos compradores coreanos.
Sempre inclua credit e debit para que clientes sem carteiras preferidas — e clientes pagando com cartões locais coreanos — ainda possam concluir o checkout.
Os métodos de pagamento coreanos requerem KRW. Se seu catálogo estiver precificado em outra moeda, habilite a Moeda Adaptativa para que os clientes coreanos sejam cotados e cobrados em KRW.
Use Kakao Pay e Naver Pay para assinaturas e PAYCO para pagamentos únicos. Incluir todos os três permite que a Dodo apresente a opção correta com base no contexto do checkout.

Solução de Problemas

Verifique:
  1. País de faturamento definido como KR?
  2. Moeda definida como KRW?
  3. Se precificado em outra moeda: Moeda Adaptativa habilitada?
  4. A carteira (kakao_pay, naver_pay, ou payco) incluída em allowed_payment_method_types?
Solução: Verifique se o endereço de faturamento tem country: "KR" e billing_currency: "KRW".
Causa: PAYCO é oferecido apenas para pagamentos únicos. Para faturamento recorrente, utilize Kakao Pay ou Naver Pay.Solução: Inclua kakao_pay e naver_pay em allowed_payment_method_types para checkouts de assinatura.
Causa: Alguns cartões coreanos operam em redes domésticas que as redes internacionais não podem processar.Solução: Mantenha credit e debit habilitados para que os cartões locais coreanos sejam roteados corretamente.

Páginas Relacionadas

Payment Methods Overview

Veja todos os métodos de pagamento suportados.

Credit & Debit Cards

Redes de cartões, incluindo cartões locais coreanos.

Adaptive Currency

Cobre clientes em sua moeda local, incluindo KRW.

Testing Process

Dados de teste e orientações de teste de checkout.
Última modificação em 18 de junho de 2026