Pular para o conteúdo

Meios de pagamento · Panamá · República Dominicana · El Salvador · Honduras · Guatemala · Colômbia

Payouts ACH no Panamá, República Dominicana, El Salvador, Honduras, Guatemala e Colômbia

Alcance contas bancárias de beneficiários pelo ACH de cada país com uma única API de payouts, horários de corte e prazos documentados, e o status final por webhook assinado.

  • Trilho de payouts
  • Panamá, República Dominicana, El Salvador, Honduras, Guatemala e Colômbia
  • Payout

Dados principais

ACH Pronto em Honduras, em números

Números publicados pelo Banco Central de Honduras.

O que é

Um fluxo de payouts sobre seis redes ACH nacionais

ACH (câmara de compensação automatizada) é a rede de transferências bancárias usada para payouts nesses mercados. A Localpayment documenta payouts ACH no Panamá, na República Dominicana, em El Salvador, em Honduras (onde se chama ACH Pronto), na Guatemala (para valores acima de GTQ 20.000) e na Colômbia. Cada país tem seu código, prazo de liquidação e, quando documentado, horário de corte. Esses mercados são cobertos apenas para payouts, exceto a Colômbia, que também tem pay-ins.

  • No mesmo dia ou D+1 no Panamá e na Colômbia; D+1 na República Dominicana, em El Salvador, em Honduras e na Guatemala
  • Cortes documentados: 14h no Panamá, 13h na República Dominicana e 15h na Colômbia, horário local
  • Uma API de payouts e um webhook assinado para o status final

Como funciona

Como funciona um payout com ACH

Os atores e as etapas seguem o fluxo documentado. O status final sempre chega por webhook assinado.

  1. 1

    Sua empresaLocalpayment:

    Envia a solicitação de payout

    POST /api/payout/ com os dados do beneficiário, valor e externalId. Verificações de compliance são aplicadas; com requireAuth, um segundo aprovador assina antes de movimentar os fundos.

  2. 2

    LocalpaymentBanco · ACH:

    Bloqueia os fundos e envia a instrução

    O payout passa de Locked a In Progress por ACH.

  3. 3

    Banco · ACHBeneficiário:

    Credita o beneficiário

    Os prazos dependem do trilho; veja os dados principais abaixo.

  4. 4

    LocalpaymentSua empresa:

    Webhook: payout concluído

    A Localpayment atualiza o payout para o status final. Webhook assinado com o status final; o comprovante de pagamento pode ser baixado.

Diagrama simplificado. Os prazos dependem do trilho e do banco; veja os dados principais abaixo.

Como funciona

Veja ACH em ação

Um passo a passo simplificado e fictício. Nomes e valores são exemplos.

  1. 1Comercio EjemploSua plataforma envia um payout de COP 850.000,00 por ACH.
  2. 2Banco EjemploO beneficiário vê o crédito de COP 850.000,00 na conta ou carteira.
  3. 3Payout concluídoSeu sistema recebe o webhook assinado e atualiza o pedido.

Dados principais

ACH: dados principais

  • Países

    Detalhe
    🇵🇦 Panamá · 🇩🇴 República Dominicana · 🇸🇻 El Salvador · 🇭🇳 Honduras · 🇬🇹 Guatemala · 🇨🇴 Colômbia
  • Moeda

    Detalhe
    USD · DOP · HNL · GTQ · COP
  • Direção

    Detalhe
    Somente payout
  • Panamá · Transferência bancária (ACH)

    Detalhe
    No mesmo dia ou D+1, corte às 14h (horário local)
  • República Dominicana · Transferência bancária (ACH)

    Detalhe
    D+1 (próximo dia útil), corte às 13h (horário local) · Até ≈ USD 10.000
  • El Salvador · Transferência bancária (ACH)

    Detalhe
    D+1 (próximo dia útil), corte às 14h (horário local)
  • Honduras · Transferência bancária (ACH Pronto)

    Detalhe
    D+1 (próximo dia útil), corte às 12h (horário local) · Até ≈ USD 10.000
  • Guatemala · Transferência bancária (ACH)

    Detalhe
    D+1 (próximo dia útil), corte às 12h (horário local) · Acima de GTQ 20.000
  • Colômbia · Transferência bancária (ACH)

    Detalhe
    No mesmo dia ou D+1, corte às 15h (horário local) · Mín. COP 40, sem valor máximo

Extraídos da documentação da Localpayment de cada país. Limites e disponibilidade podem mudar; confirme com seu gerente de conta.

Experiência do cliente

O que seu cliente vê com ACH

Autorização, limites e reembolsos conforme docs.localpayment.com. Os limites aparecem apenas quando a documentação os informa.

  • Como o cliente autoriza

    O beneficiário não precisa fazer nada. Você cria o payout com POST /api/payout/ usando o código ACH do país, o banco, o tipo e número da conta e o documento do beneficiário; se a dupla assinatura estiver habilitada, um segundo usuário o aprova no Business Portal. O beneficiário recebe o crédito na conta bancária dentro do prazo documentado.

  • Limites documentados

    Transferência bancária (ACH) (Payout): Até ≈ USD 10.000 · Transferência bancária (ACH Pronto) (Payout): Até ≈ USD 10.000 · Transferência bancária (ACH) (Payout): Acima de GTQ 20.000 · Transferência bancária (ACH) (Payout): Mín. COP 40, sem valor máximo. Por transação, conforme a documentação publicada; os limites contratuais podem variar.

  • Reembolsos e devoluções

    Se o banco do beneficiário rejeitar um payout concluído dias depois (conta encerrada ou inválida), os fundos voltam ao seu saldo Localpayment e o payout passa a Returned, com aviso por webhook. Um recall por dados errados do beneficiário é um pedido manual à nossa equipe de operações e não é garantido.

Checklist de integração

Entre em produção com ACH em cinco passos

A mesma sequência para todos os trilhos. Veja o checkout animado deste país antes de construir.

  1. Obtenha credenciais de Stage

    Solicite acesso, receba credenciais de Stage e obtenha um JWT com POST /api/token/.

  2. Abasteça seu saldo

    Os payouts são debitados do seu saldo Localpayment em moeda local; abasteça-o localmente ou via Wire In com FX.

  3. Envie o payout

    POST /api/payout/ com o beneficiário, documento, conta ou alias, valor e um externalId único.

  4. Aprove e acompanhe

    Com requireAuth um segundo usuário aprova; acompanhe Received, Locked, In Progress e Completed por webhook assinado.

  5. Veja o fluxo animado

    Cada método deste país, tela por tela, na galeria de experiências de checkout.

Por que a Localpayment

Por que usar ACH com a Localpayment

  • Uma API para pay-ins e payouts

    ACH usa a mesma API de todos os outros meios: POST /api/payin/ para receber, POST /api/payout/ para pagar, a mesma em todos os mercados.

  • Status por webhook em cada transação

    Cada mudança de status chega ao seu endpoint assinada com HMAC-SHA256, para você verificar e automatizar.

  • Conciliação no Business Portal

    Concilie cada transação com seu externalId e nosso internalId, com relatórios do Business Portal e APIs de saldo.

Perguntas frequentes

ACH: perguntas frequentes

Quais países aceitam payouts ACH?

Panamá (código 0150), República Dominicana (0080), El Salvador (0100), Honduras como ACH Pronto (0120), Guatemala acima de GTQ 20.000 (0110) e Colômbia (0060). Veja a tabela de dados principais para prazos e horários de corte.

Quanto tempo levam os payouts ACH?

Conforme a documentação, Panamá e Colômbia liquidam no mesmo dia ou em D+1, enquanto República Dominicana, El Salvador, Honduras e Guatemala liquidam em D+1. Os cortes são 14h no Panamá, 13h na República Dominicana e 15h na Colômbia, horário local.

Como envio um payout ACH?

Envie POST /api/payout/ com o país, os dados do beneficiário e o código ACH, e receba o status final por webhook assinado. Confirme os limites com seu gerente de conta.

Quais são os status do payout?

100 Received, 101 Locked (passou no compliance), 102 In Progress (enviado ao ACH), 200 Completed (creditado) e 300 Rejected, cada um entregue por webhook assinado.

O que acontece se eu enviar depois do horário de corte?

Payouts criados após o corte documentado (14h no Panamá, 13h na República Dominicana, 15h na Colômbia, horário local) entram no ciclo do próximo dia útil. Planeje seus lotes de acordo.

E se a conta do beneficiário estiver errada?

O banco receptor rejeita a transferência e você recebe o status 300 por webhook com o motivo. Os fundos permanecem no seu saldo; corrija os dados e crie um novo payout.

Preciso de uma integração separada por país?

Não. A API de payouts, o objeto de beneficiário e o webhook são os mesmos; só mudam país, moeda e código do método de pagamento. Novos países usam a mesma API.

Envie payouts com ACH

Conte quais são seus mercados e volumes. Você começa com credenciais de Stage (ambiente de testes) e nós acompanhamos até a entrada em produção.

Como podemos ajudar?

Baixe o seu exemplar

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