Vai al contenuto

Metodi di pagamento · Panama · Repubblica Dominicana · El Salvador · Honduras · Guatemala · Colombia

Payout ACH in Panama, Repubblica Dominicana, El Salvador, Honduras, Guatemala e Colombia

Raggiungi i conti bancari dei beneficiari tramite l’ACH di ogni paese con un’unica API di payout, cut-off e tempi documentati e lo stato finale tramite webhook firmato.

  • Circuito di payout
  • Panama, Repubblica Dominicana, El Salvador, Honduras, Guatemala e Colombia
  • Payout

Dati chiave

ACH Pronto in Honduras, in cifre

Dati pubblicati dalla Banca Centrale dell’Honduras.

Che cos’è

Un unico flusso di payout su sei reti ACH nazionali

L’ACH (automated clearing house) è la rete di bonifici bancari usata per i payout in questi mercati. Localpayment documenta i payout ACH in Panama, Repubblica Dominicana, El Salvador, Honduras (dove si chiama ACH Pronto), Guatemala (per importi oltre GTQ 20.000) e Colombia. Ogni paese ha il proprio codice, i propri tempi di regolamento e, dove documentato, il proprio cut-off. Questi mercati sono coperti solo per i payout, tranne la Colombia, che prevede anche i pay-in.

  • Nella stessa giornata o T+1 in Panama e Colombia; T+1 in Repubblica Dominicana, El Salvador, Honduras e Guatemala
  • Cut-off documentati: 14:00 in Panama, 13:00 in Repubblica Dominicana e 15:00 in Colombia, ora locale
  • Un’unica API di payout e un webhook firmato per lo stato finale

Come funziona

Come funziona un payout con ACH

Attori e passaggi seguono il flusso documentato. Lo stato finale arriva sempre tramite webhook firmato.

  1. 1

    La tua aziendaLocalpayment:

    Invia la richiesta di payout

    POST /api/payout/ con i dati del beneficiario, l’importo e l’externalId. Si applicano i controlli di compliance; con requireAuth, un secondo approvatore firma prima di muovere i fondi.

  2. 2

    LocalpaymentBanca · ACH:

    Blocca i fondi e invia l’istruzione

    Il payout passa da Locked a In Progress tramite ACH.

  3. 3

    Banca · ACHBeneficiario:

    Accredita il beneficiario

    Le tempistiche dipendono dal circuito; vedi i dati chiave qui sotto.

  4. 4

    LocalpaymentLa tua azienda:

    Webhook: payout completato

    Localpayment aggiorna il payout allo stato finale. Webhook firmato con lo stato finale; la prova di pagamento è scaricabile.

Schema semplificato. Le tempistiche dipendono dal circuito e dalla banca; vedi i dati chiave qui sotto.

Come funziona

ACH in azione

Un percorso semplificato e fittizio. Nomi e importi sono esempi.

  1. 1Comercio EjemploLa tua piattaforma invia un payout di COP 850.000,00 tramite ACH.
  2. 2Banco EjemploIl beneficiario vede l’accredito di COP 850.000,00 sul conto o sul wallet.
  3. 3Payout completatoIl tuo sistema riceve il webhook firmato e aggiorna l’ordine.

Dati chiave

ACH: dati chiave

  • Paesi

    Dettaglio
    🇵🇦 Panama · 🇩🇴 Repubblica Dominicana · 🇸🇻 El Salvador · 🇭🇳 Honduras · 🇬🇹 Guatemala · 🇨🇴 Colombia
  • Valuta

    Dettaglio
    USD · DOP · HNL · GTQ · COP
  • Direzione

    Dettaglio
    Solo payout
  • Panama · Bonifico bancario (ACH)

    Dettaglio
    In giornata o T+1, cut-off alle 14:00 (ora locale)
  • Repubblica Dominicana · Bonifico bancario (ACH)

    Dettaglio
    T+1 (giorno lavorativo successivo), cut-off alle 13:00 (ora locale) · Fino a ≈ USD 10.000
  • El Salvador · Bonifico bancario (ACH)

    Dettaglio
    T+1 (giorno lavorativo successivo), cut-off alle 14:00 (ora locale)
  • Honduras · Bonifico bancario (ACH Pronto)

    Dettaglio
    T+1 (giorno lavorativo successivo), cut-off alle 12:00 (ora locale) · Fino a ≈ USD 10.000
  • Guatemala · Bonifico bancario (ACH)

    Dettaglio
    T+1 (giorno lavorativo successivo), cut-off alle 12:00 (ora locale) · Oltre GTQ 20.000
  • Colombia · Bonifico bancario (ACH)

    Dettaglio
    In giornata o T+1, cut-off alle 15:00 (ora locale) · Min. COP 40, senza importo massimo

Tratti dalla documentazione Localpayment di ciascun paese. Limiti e disponibilità possono cambiare; confermali con il tuo account manager.

Esperienza del cliente

Cosa vede il tuo cliente con ACH

Autorizzazione, limiti e rimborsi come documentati su docs.localpayment.com. I limiti sono mostrati solo dove la documentazione li indica.

  • Come autorizza il cliente

    Al beneficiario non è richiesto nulla. Crei il payout con POST /api/payout/ usando il codice ACH del paese, banca, tipo e numero di conto e documento del beneficiario; se la doppia firma è abilitata, un secondo utente lo approva nel Business Portal. Il beneficiario riceve l’accredito sul suo conto bancario entro i tempi documentati.

  • Limiti documentati

    Bonifico bancario (ACH) (Payout): Fino a ≈ USD 10.000 · Bonifico bancario (ACH Pronto) (Payout): Fino a ≈ USD 10.000 · Bonifico bancario (ACH) (Payout): Oltre GTQ 20.000 · Bonifico bancario (ACH) (Payout): Min. COP 40, senza importo massimo. Per transazione, secondo la documentazione pubblicata; i limiti contrattuali possono variare.

  • Rimborsi e resi

    Se la banca del beneficiario rifiuta un payout completato giorni dopo (conto chiuso o non valido), i fondi tornano sul tuo saldo Localpayment e il payout passa a Returned, con notifica via webhook. Un recall per dati errati del beneficiario è una richiesta manuale al nostro team operations e non è garantito.

Checklist di integrazione

Vai in produzione con ACH in cinque passi

La stessa sequenza per ogni circuito. Guarda il checkout animato di questo paese prima di sviluppare.

  1. Ottieni le credenziali Stage

    Richiedi l’accesso, ricevi le credenziali sandbox e ottieni un JWT con POST /api/token/.

  2. Alimenta il tuo saldo

    I payout vengono addebitati sul tuo saldo Localpayment in valuta locale; alimentalo localmente o tramite Wire In con FX.

  3. Invia il payout

    POST /api/payout/ con beneficiario, documento, conto o alias, importo e un externalId univoco.

  4. Approva e monitora

    Con requireAuth approva un secondo utente; segui Received, Locked, In Progress e Completed via webhook firmato.

  5. Guarda il flusso animato

    Ogni metodo di questo paese, schermata per schermata, nella galleria delle esperienze di checkout.

Perché Localpayment

Perché usare ACH con Localpayment

  • Un’unica API per incassi e payout

    ACH usa la stessa API di tutti gli altri metodi: POST /api/payin/ per incassare, POST /api/payout/ per pagare e nuovi mercati per configurazione.

  • Stato via webhook per ogni transazione

    Ogni cambio di stato arriva al tuo endpoint firmato con HMAC-SHA256, così puoi verificare e automatizzare.

  • Riconciliazione nel Business Portal

    Riconcilia ogni transazione con il tuo externalId e il nostro internalId, con report del Business Portal e API di saldo.

FAQ

ACH: domande frequenti

Quali paesi supportano i payout ACH?

Panama (codice 0150), Repubblica Dominicana (0080), El Salvador (0100), Honduras come ACH Pronto (0120), Guatemala oltre GTQ 20.000 (0110) e Colombia (0060). Consulta la tabella dei dati chiave per tempi e cut-off.

Quanto tempo richiedono i payout ACH?

Secondo la documentazione, Panama e Colombia regolano nella stessa giornata o a T+1, mentre Repubblica Dominicana, El Salvador, Honduras e Guatemala regolano a T+1. I cut-off sono le 14:00 in Panama, le 13:00 in Repubblica Dominicana e le 15:00 in Colombia, ora locale.

Come invio un payout ACH?

Invia POST /api/payout/ con paese, dati del beneficiario e codice ACH e ricevi lo stato finale tramite webhook firmato. Conferma i limiti con il tuo account manager.

Quali sono gli stati del payout?

100 Received, 101 Locked (compliance superata), 102 In Progress (inviato all’ACH), 200 Completed (accreditato) e 300 Rejected, ciascuno consegnato tramite webhook firmato.

Cosa succede se invio dopo il cut-off?

I payout creati dopo il cut-off documentato (14:00 in Panama, 13:00 in Repubblica Dominicana, 15:00 in Colombia, ora locale) entrano nel ciclo del giorno lavorativo successivo. Pianifica i batch di conseguenza.

E se il conto del beneficiario è errato?

La banca ricevente rifiuta il bonifico e ricevi lo stato 300 via webhook con il motivo. I fondi restano nel tuo saldo; correggi i dati e crea un nuovo payout.

Serve un’integrazione separata per paese?

No. L’API di payout, l’oggetto beneficiario e il webhook sono gli stessi; cambiano solo paese, valuta e codice del metodo di pagamento. I nuovi paesi si abilitano per configurazione.

Invia payout con ACH

Raccontaci i tuoi mercati e i volumi. Parti con le credenziali Stage (sandbox) e ti accompagniamo fino al go-live.

Come possiamo aiutarti?

Scarica la tua copia

Lasciaci i tuoi dati e ricevi subito l’edizione completa.