Pular para o conteúdo

Cartões

Aceite cartões com um checkout pensado para cada mercado.

Visa e Mastercard na Argentina, na Colômbia, no México e no Peru, além de American Express, Diners Club, Naranja e Cabal, conforme o país. Tokenize cartões salvos, autentique com 3D Secure, ofereça parcelamento e gerencie chargebacks em uma única integração.

Fale com vendasDocumentação de cartões
  • Argentina · Colômbia · México · Peru
  • Visa, Mastercard, Amex, Diners, Naranja, Cabal
  • PEN e USD no Peru
Países: Argentina, Colômbia, México e Peru
4
Bandeiras: Visa, Mastercard, Amex, Diners, Naranja e Cabal
6
Na Colômbia, no México e no Peru
3D Secure
Na Colômbia, no México e no Peru
Parcelamento

Bandeiras

Bandeiras internacionais e as locais que as pessoas usam

Visa e Mastercard nos quatro mercados, além de American Express, Naranja e Cabal na Argentina e American Express e Diners Club na Colômbia, no crédito e no débito.

Mercado a mercado

O que está disponível em cada país

Os recursos de cartão variam por mercado. Veja o que está disponível hoje em cada país.

  • Argentina

    Pagamento único
    ✓
    Tokenização
    ✓
    Estornos
    ✓
    Chargebacks
    ✓
    3DS
    —
    Parcelamento
    —
    Assinaturas
    —

  • Colômbia

    Pagamento único
    ✓
    Tokenização
    ✓
    Estornos
    ✓
    Chargebacks
    ✓
    3DS
    ✓
    Parcelamento
    ✓
    Assinaturas
    ✓

  • México

    Pagamento único
    ✓
    Tokenização
    ✓
    Estornos
    ✓
    Chargebacks
    ✓
    3DS
    ✓
    Parcelamento
    ✓
    Assinaturas
    ✓

  • Peru

    Pagamento único
    ✓
    Tokenização
    ✓
    Estornos
    ✓
    Chargebacks
    ✓
    3DS
    ✓
    Parcelamento
    ✓
    Assinaturas
    ✓

Fonte: docs.localpayment.com. Não processamos cartões no Brasil. Use Pix e contas virtuais com chave Pix.

Recursos

Tudo de que a aceitação de cartões precisa

  • Tokenização e cartão salvo

    Substitua os dados do cartão por um token para clientes recorrentes, recompras mais rápidas e assinaturas.

  • 3D Secure

    Autenticação forte na Colômbia, no México e no Peru. Quando o emissor pede um desafio, a API retorna a URL correspondente.

  • Parcelamento

    Cote um plano de parcelas, deixe o cliente escolher e cobre. Disponível em cartões de crédito em moeda local na Colômbia, no México e no Peru (somente PEN).

  • Pré-autorização e captura

    Autorize agora e capture depois, ou libere a reserva se o pedido não seguir adiante. A disponibilidade por mercado é confirmada no onboarding.

  • Estornos

    Estorne pagamentos com cartão via API ou pelo Business Portal e baixe o comprovante.

  • Gestão de chargebacks

    Receba webhooks de chargeback e envie evidências via API dentro do prazo de resposta.

Risco

3D Secure, lista de BINs permitidos e gestão de chargebacks

Controles em camadas ajudam a barrar transações suspeitas antes que virem chargebacks.

  • 3D Secure

    Autentique portadores na Colômbia, no México e no Peru. Quando o emissor solicita o desafio, a API retorna a URL do desafio.

  • Lista de BINs permitidos

    Restrinja a aceitação a BINs pré-aprovados, por emissor e tipo de cartão, no Business Portal.

  • Gestão de chargebacks

    Receba um webhook a cada chargeback e envie as evidências pela API ou pelo Business Portal antes do prazo.

Escopo PCI

Mantenha os dados de cartão longe dos seus servidores

Capture cartões com Smart Fields, o iframe incorporado ou o WebCheckout. Os dados são digitados em campos hospedados por nós e viram um token que o seu backend envia com o pay-in.

  • Smart Fields: campos de cartão hospedados dentro da sua própria interface, com um SDK JS
  • Iframe incorporado: um checkout white-label com escopo PCI reduzido
  • WebCheckout e links de pagamento: sem código e com escopo PCI mínimo
  • TLS 1.2+ em trânsito, AES-256 em repouso
Conheça o Checkout e o Smart Fields

Como funciona

O caminho de um pagamento com cartão

  1. 01

    Captura

    O cliente digita os dados do cartão nos Smart Fields ou em um checkout hospedado, ou você reutiliza um token salvo.

  2. 02

    Autorização

    Chame POST /api/payin/ com paymentMethod.type CreditCard e o código da bandeira para o país.

  3. 03

    Autenticação, se necessária

    Se o emissor pedir 3D Secure, redirecione o cliente para a URL de desafio que vem na resposta.

  4. 04

    Confirmação

    O resultado chega em tempo real e por webhook assinado, pronto para entrega e conciliação.

Para desenvolvedores

Cobre com um cartão tokenizado

Envie o token no lugar dos dados do cartão e reutilize-o em cobranças futuras.

  • Códigos de bandeira por país, por exemplo, 1600 para Visa no México
  • Cartões de teste no Stage para aprovações, recusas e 3D Secure
  • Webhooks para aprovações, estornos e chargebacks
Guia de pagamentos com cartão
# Ilustrativo: campos simplificados; veja docs.localpayment.com para o contrato completo
curl -X POST https://api.stage.localpayment.com/api/payin/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethod": { "type": "CreditCard", "code": "1600", "flow": "DIRECT" },
    "externalId": "3f9a6c1e-0000-4000-8000-000000000042",
    "country": "MEX",
    "currency": "MXN",
    "amount": 1250.00,
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A. de C.V." },
    "payer": {
      "type": "INDIVIDUAL",
      "name": "Lucía",
      "lastname": "Méndez",
      "document": { "type": "RFC", "id": "XAXX010101000" },
      "email": "lucia.mendez@example.com"
    },
    "card": { "token": "<card-token>" }
  }'

Casos de uso

Cartões por setor

Perguntas frequentes

Vocês processam cartões no Brasil?

Não. A aceitação de cartões cobre Argentina, Colômbia, México e Peru. No Brasil, receba com Pix e contas virtuais com chave Pix, que confirmam em segundos, 24/7.

Quais bandeiras posso aceitar?

Visa e Mastercard nos quatro mercados, além de American Express, Naranja e Cabal na Argentina e American Express e Diners Club na Colômbia. Cartões de débito são aceitos nos quatro mercados.

Onde estão disponíveis 3D Secure, parcelamento e assinaturas?

Na Colômbia, no México e no Peru. O parcelamento vale para cartões de crédito em moeda local, então no Peru funciona apenas em pagamentos em PEN. Na Argentina, você pode processar pagamentos únicos, tokenizar cartões, estornar e gerenciar chargebacks.

Como funcionam os chargebacks?

Você recebe um webhook de chargeback e pode enviar evidências via API ou pelo Business Portal antes do prazo indicado na notificação. Se as evidências não chegarem a tempo, a disputa costuma ser resolvida a favor do portador do cartão.

Posso testar os fluxos de cartão antes de entrar em produção?

Sim. O Stage oferece cartões de teste para aprovações, recusas, desafios 3D Secure e erros de processamento, sem dinheiro real.

Como os dados de cartão são protegidos?

Os dados são criptografados com TLS 1.2+ em trânsito e AES-256 em repouso. Smart Fields e checkouts hospedados mantêm os dados de cartão fora dos seus servidores.

Posso guardar cartões para cobranças futuras?

Sim. A tokenização está disponível na Argentina, na Colômbia, no México e no Peru. Você guarda o token, nunca o PAN, e cobra depois em recompras ou assinaturas.

Em qual moeda os pagamentos com cartão são cobrados?

Os cartões são cobrados na moeda local de cada mercado (ARS, COP e MXN) e em PEN ou USD no Peru, e creditados na sua conta na sua moeda de liquidação.

Na mesma API

Aceite cartões do jeito local

Fale com a nossa equipe sobre a aceitação de cartões na Argentina, na Colômbia, no México e no Peru.

Fale com vendasVer a documentação de cartões

Como podemos ajudar?

Baixe o seu exemplar

Deixe seus dados e receba a edição completa na hora.