Pular para o conteúdo

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

  • Airwallex
  • LianLian Global
  • PayPal
  • XTransfer
  • TransferMate
  • PingPong
  • Global66
  • Skyee
  • TransFi
  • GCC Remit
  • Nium
  • Routefusion
  • Trolley
  • Cadana
  • neomoney
  • Rapyd
  • TerraPay
  • CurrencyBird
  • Ontop
  • Thunes
  • Triple-A
  • Xtract
  • Payoneer
  • Noah
  • Ksher
  • Manteca
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.

Fale com nosso time de vendas

Conte quais são seus mercados e volumes, e desenhamos a integração com você.

Como funciona

Da requisição ao saldo em quatro passos

  1. 01

    Requisição

    POST /api/payin/ com país (ISO-3), moeda, valor, paymentMethod e o seu externalId único.

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

  3. 03

    Webhook

    Um webhook assinado com HMAC-SHA256 traz o resultado, o seu externalId e o nosso internalId.

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

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" } } }'

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.

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.

Como podemos ajudar?

Baixe o seu exemplar

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