Pular para o conteúdo

Meios de pagamento · Argentina · Colômbia · México · Peru

Pagamentos com cartão na Argentina, Colômbia, México e Peru

Aceite cartões de crédito e débito com uma única API, de pagamentos avulsos a cartões tokenizados, com 3DS, parcelamento e assinaturas onde documentado.

Fale com vendasIr para a documentação
  • Cartão
  • Argentina, Colômbia, México e Peru
  • Pay-in

Dados principais

Cartões na Argentina, em números

Números atribuídos ao Banco Central da Argentina e às fontes ali citadas.

O que é

Redes internacionais e bandeiras locais, uma única integração

A Localpayment aceita cartões de crédito e débito na Argentina, Colômbia, México e Peru. Visa e Mastercard estão disponíveis nos quatro; a Argentina soma American Express, Diners Club e as bandeiras locais Naranja e Cabal, e a Colômbia soma American Express e Diners. No Peru você pode cobrar em PEN ou USD. Tokenização, reembolsos e gestão de chargebacks estão documentados em todos, e 3DS e parcelamento na Colômbia, no México e no Peru.

  • Visa e Mastercard nos quatro países, além de Amex, Diners, Naranja e Cabal (Argentina) e Amex e Diners (Colômbia)
  • 3DS e parcelamento na Colômbia, no México e no Peru; tokenização, reembolsos e chargebacks nos quatro
  • Cobranças de assinatura programadas e sob demanda, com retentativas, na Colômbia, no México e no Peru

Como funciona

Como funciona um pagamento com cartão

Os atores e as etapas seguem o fluxo documentado. O status final sempre chega por webhook assinado.

  1. 1

    ClienteSua empresa:

    Dados do cartão

    No checkout hospedado ou em Smart Fields; os dados do cartão são tokenizados. POST /api/payin/ com o token do cartão, valor e parcelas, se houver.

  2. 2

    LocalpaymentEmissor do cartão:

    Autorização (3DS onde disponível)

    Com 3D Secure quando aplicável (Colômbia, México e Peru).

  3. 3

    Emissor do cartãoLocalpayment:

    Confirmação

    Aprovada ou recusada; a autorização do cartão é em tempo real.

  4. 4

    LocalpaymentSua empresa:

    Webhook

    Reembolsos e chargebacks também são notificados por webhook assinado.

Diagrama simplificado. Os prazos dependem do trilho e do banco; veja os dados principais abaixo.

Como funciona

Veja Cartões em ação

Um passo a passo simplificado e fictício. Nomes e valores são exemplos.

  1. 1Comercio EjemploO cliente escolhe Cartões para pagar MXN 1.250,00.
  2. 2Comercio EjemploOs dados do cartão são informados em campos seguros e tokenizados.
  3. 3Pagamento confirmadoSeu sistema recebe o webhook assinado e libera o pedido.
Fale com vendas

Dados principais

Cartões: dados principais

  • Países

    Detalhe
    🇦🇷 Argentina · 🇨🇴 Colômbia · 🇲🇽 México · 🇵🇪 Peru

  • Moeda

    Detalhe
    ARS · COP · MXN · PEN

  • Direção

    Detalhe
    Somente pay-in

  • Bandeiras

    Detalhe
    Visa, Mastercard (AR, CO, MX, PE) · American Express (AR, CO) · Naranja, Cabal (AR) · Diners Club (AR, CO)

  • 3DS

    Detalhe
    Colômbia, México, Peru

  • Parcelamento

    Detalhe
    Colômbia, México, Peru

  • Assinaturas

    Detalhe
    Colômbia, México, Peru

Extraídos da documentação da Localpayment de cada país. Limites e disponibilidade podem mudar; confirme com seu gerente de conta.

Experiência do cliente

O que seu cliente vê com Cartões

Autorização, limites e reembolsos conforme docs.localpayment.com. Os limites aparecem apenas quando a documentação os informa.

  • Como o cliente autoriza

    O cliente informa no seu checkout o número do cartão, a validade, o CVV e o nome do titular (ou seleciona um cartão tokenizado salvo antes) e, na Colômbia, no México e no Peru, escolhe o número de parcelas quando oferecido. Se o 3DS se aplicar, o emissor pode exibir um desafio: um código de uso único ou uma confirmação no app do banco. O resultado da autorização volta de forma síncrona e o status final também chega por webhook.

  • Limites documentados

    Cartões de crédito (Pay-in): Mín. ARS 50 · Cartões de débito (Pay-in): ARS 50 – 10.000.000 · Cartões de crédito (Pay-in): COP 1.000 – 5.000.000 · Cartões de débito (Pay-in): COP 1.000 – 5.000.000 · Cartões de crédito (Pay-in): MXN 10 – 300.000 · Cartões de débito (Pay-in): MXN 10 – 300.000 · Cartões de crédito (Pay-in): PEN 1 – 30.000 · Cartões de débito (Pay-in): PEN 1 – 30.000. Por transação, conforme a documentação publicada; os limites contratuais podem variar.

  • Reembolsos e devoluções

    Os reembolsos são diretos e apenas totais, com PATCH /api/payin/{externalId}/refund e somente o externalId. Os chargebacks chegam por webhook e no Business Portal; você tem 7 dias para enviar evidências, caso contrário a disputa é encerrada a favor do portador.

Checklist de integração

Entre em produção com Cartões em cinco passos

A mesma sequência para todos os trilhos. Veja o checkout animado deste país antes de construir.

  1. Obtenha credenciais de Stage

    Solicite acesso, receba credenciais de Stage e obtenha um JWT com POST /api/token/.

  2. Crie o pay-in

    POST /api/payin/ com o código Localpayment da tabela de dados principais, país ISO-3, moeda, valor e dados do pagador.

  3. Mostre as instruções

    Exiba o QR, o código, o redirecionamento ou os dados da conta da resposta e respeite a data de expiração.

  4. Verifique o webhook

    Valide x-Signature (HMAC-SHA256), libere o pedido no status 200 e deduplique por externalId.

  5. Veja o checkout animado

    Cada método deste país, tela por tela, na galeria de experiências de checkout.

História

Como a aceitação de cartões foi moldada na Argentina e no México

Fontes: Lei 25.065 (Argentina); Banco Central de la República Argentina, Comunicación “A” 6212; Banco de México, regulação de pagamentos com cartão 2004–2014; EMVCo, especificação EMV 3-D Secure.

  1. Argentina: Lei de Cartões de Crédito

    A Lei 25.065, publicada em 14 de janeiro de 1999, fixa as regras dos sistemas de cartões de crédito, débito e compra na Argentina, com o banco central como autoridade em matéria financeira.

  2. México: intercâmbio menor

    O Banco do México pressiona pela queda das tarifas de intercâmbio: a média ponderada para cartões de crédito cai de 2,4% em 2004 para 1,84% em 2006, com tarifas menores para débito do que para crédito.

  3. México: regras da Reforma Financeira

    Após a Reforma Financeira, o Banco do México e a comissão bancária emitem disposições gerais para as redes de meios de pagamento e, em outubro de 2014, regras para as câmaras de compensação de pagamentos com cartão, com menores custos de processamento e mais transparência.

  4. EMV 3-D Secure 2.0

    A EMVCo publica em 25 de outubro de 2016 a especificação EMV 3-D Secure 2.0, o protocolo de autenticação por trás dos fluxos 3DS documentados para Colômbia, México e Peru.

  5. Argentina: tetos para o intercâmbio

    Com a Comunicación “A” 6212 (31 de março de 2017), o banco central fixa tetos para as tarifas de intercâmbio, com uma trajetória até 1,5% no crédito e 0,6% no débito em 2021.

Por que a Localpayment

Por que usar Cartões com a Localpayment

  • Uma API para pay-ins e payouts

    Cartões usam a mesma API de todos os outros meios: POST /api/payin/ para receber, POST /api/payout/ para pagar, a mesma em todos os mercados.

  • Status por webhook em cada transação

    Cada mudança de status chega ao seu endpoint assinada com HMAC-SHA256, para você verificar e automatizar.

  • Conciliação no Business Portal

    Concilie cada transação com seu externalId e nosso internalId, com relatórios do Business Portal e APIs de saldo.

Continue explorando

Perguntas frequentes

Cartões: perguntas frequentes

Quais cartões posso aceitar?

Visa e Mastercard na Argentina, Colômbia, México e Peru; American Express, Diners Club, Naranja e Cabal na Argentina; American Express e Diners na Colômbia. No Peru cada bandeira tem um código para PEN e outro para USD. Os códigos por bandeira e país estão na tabela de dados principais.

3DS, parcelamento e assinaturas estão disponíveis em todos os países?

3DS, parcelamento e assinaturas com cartão (programadas e sob demanda, com retentativas) estão documentados para Colômbia, México e Peru. Para a Argentina, a documentação cobre pagamentos avulsos, tokenização, reembolsos e chargebacks. Confirme sua configuração com seu gerente de conta.

Posso aceitar cartões no Brasil?

Não. Os cartões são oferecidos na Argentina, Colômbia, México e Peru. Para o Brasil, veja o Pix.

Como funciona a tokenização?

No primeiro pagamento você pode solicitar um token; a Localpayment guarda os dados do cartão sob PCI DSS e retorna um token que você reutiliza em cobranças posteriores, assinaturas ou checkout em um clique. Seus sistemas nunca armazenam o PAN.

Como são tratados os chargebacks?

Quando o emissor abre uma disputa, a Localpayment notifica o caso e o prazo, você apresenta suas evidências e o resultado é notificado. Um reembolso feito antes da abertura da disputa costuma evitá-la. Veja a seção de chargebacks da documentação de cartões de cada país.

Posso reembolsar um pagamento com cartão parcialmente?

Os reembolsos com cartão são solicitados com PATCH /api/payin/{externalId}/refund e os fundos voltam para o mesmo cartão. Verifique o prazo de reembolso e se reembolsos parciais estão habilitados para sua conta em cada país antes de construir o fluxo.

O 3DS reduz a taxa de aprovação?

Um desafio 3DS adiciona uma etapa, mas transfere a responsabilidade por fraude ao emissor e costuma ser sem atrito com o EMV 3DS 2.0. Use-o onde está documentado (Colômbia, México e Peru) e ajuste seu uso com seu gerente de conta conforme seu perfil de risco.

Adicione Cartões aos seus recebimentos

Conte quais são seus mercados e volumes. Você começa com credenciais de Stage (ambiente de testes) e nós acompanhamos até a entrada em produção.

Fale com vendasIr para a documentação

Como podemos ajudar?

Baixe o seu exemplar

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