Payins
Deixe seus clientes pagarem do jeito que já estão acostumados no país deles.
Aceite cartões, contas virtuais, Pix, PSE, Bre-B e QR em moeda local em mercados locais com uma única integração, e liquide cada recebimento em um só saldo.
- Payins em mercados locais
- Uma integração para todos os mercados
- Moeda local, um só saldo
Empresas globais que operam com a Localpayment
- Pix · PSE
- Payins locais com uma única API
- CLABE · CVU
- Formatos de conta locais
- Pix · SPEI
- Trilhos de pagamento locais, em tempo real, 24/7
- Webhooks
- Status em tempo real de cada pagamento
Por que a Localpayment
Receba mais, integre uma vez, concilie menos
Cartões internacionais são só parte do cenário. Na região, as pessoas pagam com transferência e QR, e cada país faz isso do seu jeito.
Os métodos que as pessoas já usam
Pix, PSE, Bre-B, CVU, CLABE, QR e cartões em uma única integração, para que compradores que preferem transferência ou QR não desistam.
Uma integração para todos os mercados
Cada mercado tem seus próprios trilhos, documentos, limites e regras. Com a Localpayment, a requisição segue o mesmo formato em todos os países e novos mercados são habilitados por configuração.
Confirmação em segundos
Autorizações de cartão são em tempo real, e trilhos em tempo real como Pix, SPEI, TEF, CCE e Bre-B confirmam em segundos, 24/7.
Um saldo, um relatório
Cada recebimento é creditado na sua conta Localpayment na sua moeda de liquidação, normalmente USD, e conciliado nos mesmos relatórios, sem conferir à mão pagamentos de vários provedores.
Um saldo, um relatório —
Fale com nosso time de vendas
Conte quais são seus mercados e volumes, e desenhamos a integração com você.
Casos de uso
Cobrança pensada para cada setor
E-commerce e marketplaces
Cartões, Pix, PSE e SPEI no checkout, com reembolsos pela mesma API.
E-commerce e marketplaces —Bens digitais e streaming
Onde o trilho é instantâneo, o conteúdo é liberado assim que o pagamento é confirmado.
Bens digitais e streaming —SaaS
Receba assinaturas localmente e liquide na sua moeda forte.
SaaS —Viagens
Pagamentos de alto valor por transferência bancária, com confirmação por webhook.
Viagens —
Métodos
Métodos locais disponíveis, um só endpoint.
Escolha os métodos que cada mercado prefere: sua integração é a mesma em todos os países.
Cartões
- ar
- co
- mx
- pe
Visa e Mastercard na Argentina, na Colômbia, no México e no Peru, além de American Express e Diners Club na Argentina e na Colômbia.
Cartões —Contas virtuais
- ar
- br
- cl
- co
- cr
- mx
- pe
Uma CVU, chave Pix, CLABE, CCI, IBAN, chave Bre-B ou número de conta chileno exclusivo para cada cliente, fatura ou pedido.
Contas virtuais —Meios de pagamento locais (APMs)
- ar
- bo
- br
- cl
- co
- gt
- pe
Pix no Brasil, PSE na Colômbia, Debin e QR na Argentina, ETPAY no Chile, QR na Bolívia e no Peru, e QR Fri e Wallet Fri na Guatemala.
Meios de pagamento locais (APMs) —Assinaturas
- co
- mx
- pe
Planos programados ou cobranças sob demanda, com retentativas configuráveis.
Assinaturas —
Como funciona
Da requisição ao saldo em quatro passos
- 01
Requisição
POST /api/payin/ com país (ISO-3), moeda, valor, paymentMethod e o seu externalId único.
- 02
O cliente paga
O cliente recebe um QR Code, chave, referência ou redirecionamento, conforme o meio. Cartões são autorizados em tempo real; contas virtuais e meios de pagamento locais são confirmados de forma assíncrona.
- 03
Webhook
Um webhook assinado com HMAC-SHA256 traz o resultado, o seu externalId e o nosso internalId.
- 04
Saldo creditado
O recebimento é creditado na sua conta Localpayment, na moeda de liquidação (normalmente USD).
Cobertura
Métodos de payin por país
Argentina
- Contas virtuais
- CVU
- Cartões
- Sim
- Métodos locais
- QR · Debin
Bolívia
- Contas virtuais
- —
- Cartões
- —
- Métodos locais
- QR
Brasil
- Contas virtuais
- Chave Pix
- Cartões
- —
- Métodos locais
- Pix
Chile
- Contas virtuais
- Conta bancária (TEF)
- Cartões
- —
- Métodos locais
- ETPAY
Colômbia
- Contas virtuais
- Chave Bre-B
- Cartões
- Sim
- Métodos locais
- PSE
Costa Rica
- Contas virtuais
- IBAN (SINPE)
- Cartões
- —
- Métodos locais
- —
Guatemala
- Contas virtuais
- —
- Cartões
- —
- Métodos locais
- QR Fri · Wallet Fri
México
- Contas virtuais
- CLABE
- Cartões
- Sim
- Métodos locais
- —
Peru
- Contas virtuais
- CCI
- Cartões
- Sim
- Métodos locais
- QR
Fonte: guias por país em docs.localpayment.com. A disponibilidade é confirmada para cada empresa durante o onboarding.
Ciclo de vida
Gerencie todo o ciclo do pagamento
Tudo o que acontece depois do pagamento fica na mesma plataforma, via API ou pelo Business Portal.
- Reembolsos de pagamentos com cartão, conta virtual e APM
- Gestão de chargebacks com envio de evidências via API
- Cancelamento de pagamentos APM pendentes antes da aprovação do pagador
- Download de comprovantes de reembolso
- Checkouts dinâmicos com o endpoint Get Available Payment Methods
- Câmbio no momento do pagamento, com taxa travada por um token de cotação
- 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
Um endpoint, campos específicos por país.
Autentique com POST /api/token/ e chame o mesmo endpoint Create Payin para qualquer país, com os campos que esse país exige. Este exemplo de Pix retorna um QR Code e é confirmado por webhook.
- Tokens Bearer: acesso válido por 5 minutos e renovação por 24 horas
- Seu externalId em cada requisição; duplicados retornam HTTP 409
- O Stage espelha a produção, sem dinheiro real
# 1) Obtenha um token de acesso (Stage). Guarde as credenciais em um gerenciador de segredos. curl -X POST https://api.stage.localpayment.com/api/token/ \ -H "Content-Type: application/json" \ -d '{ "username": "<api-user>", "password": "<from-your-secrets-manager>" }' # 2) Crie um payin Pix (valores fictícios) 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": "1314", "flow": "DIRECT" }, "externalId": "7c1e2f7a-0000-4000-8000-000000000001", "country": "BRA", "currency": "USD", "amount": 100, "accountNumber": "<your-account-number>", "conceptCode": "0003", "merchant": { "type": "COMPANY", "name": "Loja Exemplo Ltda" }, "payer": { "type": "INDIVIDUAL", "name": "Maria", "lastname": "Silva", "document": { "type": "CPF", "id": "000.000.000-00" } } }'
// Node.js 18+ (built-in fetch) · Stage · fictitious values const BASE_URL = 'https://api.stage.localpayment.com'; // 1) Obtenha um token de acesso (Stage). Guarde as credenciais em um gerenciador de segredos. const tokenRes = await fetch(`${BASE_URL}/api/token/`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ username: process.env.LP_API_USER, password: process.env.LP_API_PASSWORD, }), }); const { access } = await tokenRes.json(); // 2) Crie um payin Pix (valores fictícios) const res = await fetch(`${BASE_URL}/api/payin/`, { method: 'POST', headers: { Authorization: `Bearer ${access}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ paymentMethod: { type: 'BankTransfer', code: '1314', flow: 'DIRECT' }, externalId: crypto.randomUUID(), country: 'BRA', currency: 'USD', amount: 100, accountNumber: process.env.LP_ACCOUNT_NUMBER, conceptCode: '0003', merchant: { type: 'COMPANY', name: 'Loja Exemplo Ltda' }, payer: { type: 'INDIVIDUAL', name: 'Maria', lastname: 'Silva', document: { type: 'CPF', id: '000.000.000-00' }, }, }), }); const payin = await res.json(); // Mostre payin.qr.code (Pix Copia e Cola) ao seu cliente; o status final chega por webhook.
{ "transactionType": "PayIn", "externalId": "7c1e2f7a-0000-4000-8000-000000000001", "internalId": "b4c1d2e3-0000-4000-8000-00000000abcd", "paymentMethod": { "type": "BankTransfer", "code": "1314", "flow": "DIRECT" }, "country": "BRA", "currency": "USD", "amount": 100, "payment": { "currency": "BRL", "fxQuote": 5.0, "amount": 500.00 }, "status": { "code": "100", "description": "INPROGRESS", "detail": "The payin is pending the confirmation" }, "qr": { "code": "<pix-emv-code>", "expirationDate": "2026-10-01T12:00:00-03:00" }, "errors": [] }
Perguntas frequentes
Qual é a minha moeda de liquidação?
Normalmente USD. Os recebimentos em moeda local são creditados na sua conta Localpayment na sua moeda de liquidação. Você também pode converter saldos locais em outras moedas fortes, como EUR ou GBP, dentro do horário do mercado local.
Os pagamentos são confirmados em tempo real?
Autorizações de cartão são em tempo real. Trilhos em tempo real como Pix, SPEI, COELSA, TEF, CCE e Bre-B confirmam em segundos, 24/7. Os demais métodos são confirmados de forma assíncrona, e todo status final chega por webhook.
Como sei que um pagamento foi concluído?
Você recebe um webhook assinado com HMAC-SHA256 no cabeçalho X-Signature. Um status.code 200 significa COMPLETED. Você também pode consultar GET /api/transactions/{externalId}/status.
Posso reembolsar um pagamento?
Sim. Pagamentos com cartão, conta virtual e APM podem ser reembolsados via API ou pelo Business Portal.
Preciso de uma integração diferente para cada país?
Não. O formato da requisição é o mesmo em todos os mercados; mudam o código do país, a moeda e o meio de pagamento.
Como começo a testar?
As credenciais de Stage são emitidas no início da parceria. O Stage espelha a produção sem dinheiro real, então você testa cada fluxo antes de entrar em produção.
Quais métodos de pagamento posso oferecer em cada país?
Cartões na Argentina, na Colômbia, no México e no Peru, e contas virtuais e meios de pagamento locais (APMs) onde estiverem documentados por país. O diretório de métodos de pagamento lista cada método, código e prazo; sua equipe de conta os habilita para você.
Posso receber em dólares?
Sim, com contas virtuais em USD no México (SPID) e na Costa Rica, e cartões em USD no Peru. Na maioria dos países o pagador paga em moeda local e o valor é creditado na sua conta na sua moeda de liquidação.
Na mesma API
Contas virtuais
Um número de conta local exclusivo por cliente, conciliado automaticamente.
Contas virtuais —Payouts
Pagamentos para contas bancárias em trilhos locais de mercados locais e para carteiras onde são oferecidas.
Payouts —Conciliação e relatórios
Relatórios, APIs e webhooks para equipes financeiras.
Conciliação e relatórios —
Comece a receber localmente
Receba credenciais de Stage no início da parceria, entre em produção em semanas, com a mesma API em todos os mercados.

Payins em mercados locais

























