Pay-ins

Deixe seus clientes pagarem do jeito que já estão acostumados no país deles.

Ofereça no checkout os meios de pagamento locais disponíveis, acompanhe a confirmação de cada transação e integre os valores recebidos ao resto da sua operação.

Fale com vendas Ver a documentação de pay-ins

Um endpoint: POST /api/payin/
Moeda local, um só saldo
Webhooks assinados para cada status

Países com pay-ins: 9
Países com contas virtuais: 7
Países com cartões: Argentina, Colômbia, México e Peru: 4
Status em tempo real de cada pagamento: Webhooks

O desafio

Receber só do exterior faz você perder vendas

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.

Sem um parceiro local

Só cartõesMuitos compradores preferem transferência ou QR e desistem sem essas opções.
Uma integração por paísCada mercado tem seus próprios trilhos, documentos, limites e regras.
Conciliação manualConferir à mão pagamentos de vários provedores é lento e sujeito a erros.

Com a Localpayment

Os métodos que as pessoas já usamPix, PSE, Bre-B, CVU, CLABE, QR e bandeiras locais de cartão em uma única integração.
Uma estrutura para todos os paísesUm endpoint para todos os países: os campos base são os mesmos (country, currency, amount, paymentMethod, externalId), e cada país pede os seus campos próprios.
Um saldo, um relatório, um formato de webhookCada recebimento é creditado na sua conta e conciliado nos mesmos relatórios.

Métodos

Métodos locais disponíveis, um só endpoint.

Escolha os métodos que cada mercado prefere. A requisição segue o mesmo formato; mudam o código do método, o país, a moeda e os campos exigidos pelo país.

Fluxo do dinheiro

Do checkout ao seu saldo

Uma requisição cria o pagamento; o trilho local confirma; um webhook assinado avisa sua plataforma.

1
ClienteSua plataforma:
1Escolhe um meio local
Pix, SPEI, PSE, Bre-B, cartões ou qualquer meio disponível no país.
2
Sua plataformaLocalpayment:
2POST /api/payin/
Valor, moeda, país e dados do pagador em uma requisição.
3
LocalpaymentCliente:
3Instruções de pagamento
QR Code, chave, referência ou redirecionamento, conforme o meio.
4
ClienteTrilho local / banco:
4Paga no app do banco
O pagador autoriza no próprio banco ou carteira.
5
Trilho local / bancoLocalpayment:
5O trilho confirma
Os trilhos em tempo real confirmam em segundos; os demais seguem seus horários de corte.
6
LocalpaymentSua plataforma:
6Webhook assinado
Seu sistema libera o pedido e o saldo é creditado.

Fluxo ilustrativo. O tempo de confirmação e os horários de corte dependem do meio e do país.

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
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).

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

Conheça relatórios e conciliação

webhooks · entregas

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

Referência da API Create Payin

# 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 pay-in 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" }
    }
  }'

Cobertura

Métodos de pay-in 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

País	Contas virtuais	Cartões	Métodos locais
Argentina	CVU	Sim	QR · Debin
Bolívia	—	—	QR
Brasil	Chave Pix	—	Pix
Chile	Conta bancária (TEF)	—	ETPAY
Colômbia	Chave Bre-B	Sim	PSE
Costa Rica	IBAN (SINPE)	—	—
Guatemala	—	—	QR Fri · Wallet Fri
México	CLABE	Sim	—
Peru	CCI	Sim	QR

Fonte: guias por país em docs.localpayment.com. A disponibilidade é confirmada para cada empresa durante o onboarding.

Casos de uso

Cobrança pensada para cada setor

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.

Deixe seus clientes pagarem do jeito que já estão acostumados no país deles.

Receber só do exterior faz você perder vendas

Sem um parceiro local

Com a Localpayment

Métodos locais disponíveis, um só endpoint.

Cartões

Contas virtuais

Meios de pagamento locais (APMs)

Assinaturas

Do checkout ao seu saldo

Da requisição ao saldo em quatro passos

Requisição

O cliente paga

Webhook

Saldo creditado

Gerencie todo o ciclo do pagamento

Um endpoint, campos específicos por país.

Métodos de pay-in por país

Cobrança pensada para cada setor

E-commerce e marketplaces

Bens digitais e streaming

SaaS

Viagens

Perguntas frequentes

Na mesma API

Contas virtuais

Payouts

Conciliação e relatórios

Comece a receber localmente

Baixe o seu exemplar