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 e Diners Club, conforme o país. Tokenize cartões salvos, autentique com 3D Secure, ofereça parcelamento e gerencie chargebacks em uma única integração.
- PCI DSS v4.0.1
- SOC 2 Type II
- ISO 27001
- AML/KYC
- TLS 1.2+ · AES-256
- Argentina · Colômbia · México · Peru
- Visa, Mastercard, Amex, Diners
- PEN e USD no Peru
Argentina · Colômbia · México · Peru- Pix · SPEI
- Rieles de pago locales, en tiempo real, 24/7
- 4
- Bandeiras: Visa, Mastercard, Amex e Diners
- 3D Secure
- Na Colômbia, no México e no Peru
- Parcelamento
- Na Colômbia, no México e no Peru
Por que a Localpayment
Converta mais pagamentos com cartão, com menos risco
Recompras mais rápidas
Substitua os dados do cartão por um token nos quatro mercados, para que clientes recorrentes paguem mais rápido e as assinaturas sejam cobradas no cartão salvo.
Tíquetes maiores com parcelamento
Permita que seus clientes parcelem compras no cartão de crédito, em moeda local, na Colômbia, no México e no Peru.
Menos fraude
3D Secure na Colômbia, no México e no Peru, lista de BINs permitidos e gestão de chargebacks barram transações suspeitas antes que virem chargebacks.
Menos escopo PCI
Smart Fields, o iframe incorporado e o WebCheckout capturam os dados do cartão em campos hospedados por nós, então os dados brutos nunca chegam aos seus servidores.
Menos escopo PCI —
Fale com nosso time de vendas
Conte quais são seus mercados e volumes, e desenhamos a integração com você.
Bandeiras
As bandeiras internacionais que as pessoas já usam
Visa e Mastercard nos quatro mercados, além de American Express e Diners Club na Argentina e na Colômbia, no crédito e no débito.
Argentina
- ar
Crédito: Visa, Mastercard, American Express e Diners Club. Débito: Visa Débito, Mastercard Débito e Maestro.
Argentina —Colômbia
- co
Crédito: Visa, Mastercard, American Express e Diners Club. Débito: Visa e Mastercard.
Colômbia —México
- mx
Crédito e débito: Visa e Mastercard.
México —Peru
- pe
Crédito e débito: Visa e Mastercard, com cobrança em PEN ou USD.
Peru —
ar
co
mx
peCasos de uso
Cartões por setor
E-commerce e marketplaces
Parcelamento na Colômbia, no México e no Peru ajuda a vender itens de alto valor.
E-commerce e marketplaces —SaaS
Tokenize uma vez e cobre assinaturas com retentativas configuráveis.
SaaS —Bens digitais e streaming
Recompras em um clique com tokens salvos, com 3D Secure onde disponível.
Bens digitais e streaming —Viagens
Aceite os cartões locais que o adquirente internacional não alcança.
Viagens —
Como funciona
O caminho de um pagamento com cartão
- 01
Captura
O cliente digita os dados do cartão nos Smart Fields ou em um checkout hospedado, ou você reutiliza um token salvo.
- 02
Autorização
Chame POST /api/payin/ com paymentMethod.type CreditCard e o código da bandeira para o país.
- 03
Autenticação, se necessária
Se o emissor pedir 3D Secure, redirecione o cliente para a URL de desafio que vem na resposta.
- 04
Confirmação
O resultado chega em tempo real e por webhook assinado, pronto para entrega e conciliação.
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
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.
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.
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 payin.
- 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
Playground de API
Cobre um cartão tokenizado
POST /api/payin/ com um token de cartão no México (Visa, código 1600). Enter mostra 103 APPROVED e depois o webhook de crédito.
A barra 80/20 é uma divisão ilustrativa do storyboard.
Saldos ilustrativos
- USD25,000.00
- ARS250,000.00
- BRL184,200.00
- MXN310,500.00
Os saldos se movem só dentro deste demo, com os valores de exemplo.
us
pa
svUSD neste demo: Estados Unidos, Panamá, Peru e El Salvador.
POST /api/payin/
Authorization: Bearer <DEMO_TOKEN>
DEMO · Nada é enviado. Este demo não chama Stage nem Produção.
POST /api/payin/
A resposta simulada aparece aqui
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
# 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>" } }'
// Ilustrativo: campos simplificados; veja docs.localpayment.com para o contrato completo const res = await fetch('https://api.stage.localpayment.com/api/payin/', { method: 'POST', headers: { Authorization: `Bearer ${accessToken}`, // from POST /api/token/ 'Content-Type': 'application/json', }, body: JSON.stringify({ paymentMethod: { type: 'CreditCard', code: '1600', flow: 'DIRECT' }, // Visa · Mexico externalId: crypto.randomUUID(), country: 'MEX', currency: 'MXN', amount: 1250.0, accountNumber: process.env.LP_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: storedCardToken }, // token de POST /api/card ou dos Smart Fields }), }); const payin = await res.json(); // status.description: APPROVED, REJECTED…
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 e Diners Club na Argentina e 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
Checkout
Campos hospedados, iframe e opções sem código que reduzem o seu escopo PCI.
Checkout —Pagamentos recorrentes
Assinaturas com cartão e retentativas configuráveis na Colômbia, no México e no Peru.
Pagamentos recorrentes —Payins
Adicione contas virtuais, QR e métodos locais ao lado dos cartões com o mesmo endpoint.
Payins —Cobertura
Presença licenciada, registrada ou supervisionada em moedas locais, com trilhos locais. Veja país por país.
Cobertura —Diretório de métodos de pagamento
Todos os métodos documentados, com códigos, limites e prazos por país.
Diretório de métodos de pagamento —Experiências de checkout
Confira, tela por tela, o que o pagador vê em cada método.
Experiências de checkout —Guia rápido para desenvolvedores
Obtenha um token, envie sua primeira requisição e receba um webhook no Stage.
Guia rápido para desenvolvedores —
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.