Meios de pagamento locais
Abra espaço para os meios de pagamento que seus clientes já usam no app do banco.
Transferências entre contas e QR Codes aprovados pelo pagador no internet banking ou no app do banco, além do Wallet Fri na Guatemala. Sem dados de cartão para capturar, e todo status final chega por webhook assinado.
- Pix · PSE · Debin · ETPAY
- QR em 4 países e Wallet Fri
- O mesmo endpoint Create Payin
Pix · PSE · Debin · ETPAY- Pagamentos entre contas no Brasil e na Colômbia
- Pix · PSE
- Países com pagamentos por QR: Argentina, Bolívia, Guatemala e Peru
- 4
- Pagamentos bancários na Argentina e no Chile
- Debin · ETPAY
- Pagamentos com carteira na Guatemala
- Wallet Fri
Métodos
Trilhos A2A, QR e carteiras, mercado a mercado
Cada método segue as regras e os limites locais. A sua integração continua a mesma.
A2A
- br
- co
- ar
- cl
Pix no Brasil, PSE na Colômbia, Debin na Argentina e ETPAY no Chile. O pagador aprova com o próprio banco.
A2A —QR
- ar
- bo
- gt
- pe
QR Codes na Argentina, na Bolívia, na Guatemala (QR Fri) e no Peru. O pagador escaneia e aprova no app do banco ou da carteira.
QR —Carteiras
- gt
Wallet Fri na Guatemala. O pagador recebe uma notificação push no app Wallet Fri e autoriza o pagamento ali; o status final chega por webhook.
Carteiras —
br
co
ar
cl
bo
gt
peComo funciona
Quatro passos, um só endpoint
- 01
Crie o pay-in
Chame POST /api/payin/ e escolha o código do método, por exemplo, 1314 para Pix ou 1936 para PSE.
- 02
Mostre o QR ou redirecione
Exiba o QR Code ou as instruções de pagamento, ou envie o pagador ao fluxo do banco no caso do PSE.
- 03
O pagador aprova
A aprovação acontece no internet banking ou no app do próprio pagador. Nenhum dado de cartão passa pelo seu checkout.
- 04
Status por webhook
O status final chega de forma assíncrona, assinado com HMAC-SHA256.
Diretório
Métodos locais por país
Meios A2A e QR, além do Wallet Fri, documentados hoje.
Argentina
- Métodos locais
- QR · Debin
Bolívia
- Métodos locais
- QR
Brasil
- Métodos locais
- Pix
Chile
- Métodos locais
- ETPAY
Colômbia
- Métodos locais
- PSE
Guatemala
- Métodos locais
- QR Fri · Wallet Fri
Peru
- Métodos locais
- QR
Fonte: guias por país em docs.localpayment.com. Na Colômbia, o Bre-B é recebido por contas virtuais (chave Bre-B). A disponibilidade é confirmada para cada comerciante durante o onboarding.
Operações
Assíncronos por natureza, conciliados como todo o resto
Métodos locais são confirmados quando o pagador aprova, não quando você envia a requisição. Nós acompanhamos o pagamento e enviamos o status final por webhook assinado.
- Webhooks assinados com X-Signature: HMAC-SHA256
- Cancelamento de pagamentos pendentes antes da aprovação do pagador
- Reembolsos de pagamentos APM
- O mesmo formato de relatório de cartões e contas virtuais
- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }Para desenvolvedores
Adicione PSE com a mesma requisição
Troque o país, a moeda, o paymentMethod.code e o flow (REDIRECT); a estrutura da requisição continua a mesma. O PSE usa um fluxo de redirecionamento, e a resposta inclui a URL do portal do banco do pagador.
- Pix 1314 · PSE 1936 · cada método escolhido pelo seu código
- Get Available Payment Methods para montar um checkout dinâmico
- Cancele pagamentos pendentes ou reembolse via API
# Ilustrativo: PSE (Colômbia), campos simplificados; veja docs.localpayment.com
curl -X POST https://api.stage.localpayment.com/api/payin/ \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"paymentMethod": { "type": "BankTransfer", "code": "1936", "flow": "REDIRECT" },
"externalId": "c2b8e6d4-0000-4000-8000-000000000019",
"country": "COL",
"currency": "COP",
"amount": 350000,
"accountNumber": "<your-account-number>",
"conceptCode": "0001",
"merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A.S.", "merchantId": "<your-merchant-id>" },
"payer": {
"type": "INDIVIDUAL",
"name": "Camila",
"lastname": "Rojas",
"document": { "type": "CC", "id": "1000000000" },
"email": "camila.rojas@example.com"
}
}'Casos de uso
Onde os métodos locais fazem a diferença
E-commerce e marketplaces
Ofereça Pix, PSE e QR ao lado dos cartões para que mais compradores paguem como preferem.
E-commerce e marketplaces —Bens digitais e games
Confirmação rápida para recargas e compras dentro do jogo, sem precisar de cartão.
Bens digitais e games —Fintechs e carteiras
Permita que os usuários recarreguem o saldo pelo app do banco em segundos, com trilhos em tempo real como o Pix.
Fintechs e carteiras —Viagens
Receba reservas em moeda local com métodos nativos dos bancos.
Viagens —
Perguntas frequentes
O que é um APM?
Meios de pagamento alternativos são trilhos locais nativos do sistema bancário: transferências bancárias instantâneas, esquemas QR e fluxos entre contas. O pagador conclui o pagamento no próprio app do banco ou da carteira, sem digitar dados de cartão.
Com que rapidez os pagamentos são confirmados?
O Pix confirma em segundos, 24/7. Os APMs são assíncronos: o pagador aprova fora do seu checkout, e todo status final chega por webhook.
Posso cancelar ou reembolsar um pagamento APM?
Sim. Pagamentos pendentes podem ser cancelados antes da aprovação do pagador, e pagamentos APM concluídos podem ser reembolsados.
Qual é a validade de uma solicitação Debin?
As solicitações Debin na Argentina expiram em dois dias se o pagador não as aprovar.
Preciso de uma nova integração para cada método?
Não. Todos os métodos usam o mesmo endpoint Create Payin; você só muda o código do método, o país e a moeda.
Como o pagador conclui um pagamento com APM?
Conforme o meio, ele é redirecionado ao banco (PSE), escaneia um QR Code ou aprova uma solicitação no app do banco ou no Wallet Fri. A página de experiências de checkout mostra cada fluxo tela a tela.
Em qual moeda o pagamento é feito?
Na moeda local de cada país (por exemplo BRL para Pix, COP para PSE e CLP para ETPAY) e creditado na sua conta Localpayment na sua moeda de liquidação.
Na mesma API
Pay-ins
Cartões, contas virtuais, meios locais e assinaturas por um único endpoint Create Payin.
Pay-ins —Contas virtuais
Um número de conta local exclusivo para cada cliente ou fatura.
Contas virtuais —Payouts
Precisa pagar em carteiras digitais? Envie fundos para Yape, SINPE Móvil, carteiras CCE e outras.
Payouts —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 —
Ofereça os métodos que a América Latina prefere
Defina com a nossa equipe de pagamentos os métodos locais certos para cada um dos seus mercados.