Vai al contenuto

Metodi di pagamento · Colombia

TransfiYa in Colombia: payout in tempo reale

Paga i beneficiari in Colombia in tempo reale, fino a COP 50.000.000 per bonifico, e ricevi lo stato finale via webhook.

  • Circuito di payout
  • Colombia
  • Payout

Dati chiave

Payout conto-a-conto in Colombia

Fonti: Banco de la República, Superintendencia Financiera, Banca Mondiale.

Che cos’è

Un circuito di payout in tempo reale per la Colombia

TransfiYa permette di inviare denaro in tempo reale a beneficiari in Colombia. In Localpayment è un metodo di payout (codice 0061) con un massimale documentato di COP 50.000.000 per bonifico. I payout passano per controlli di compliance, doppia firma opzionale e blocco dei fondi prima dell’invio dell’istruzione.

  • Payout in tempo reale, codice 0061
  • Fino a COP 50.000.000 per bonifico
  • Doppia firma opzionale; stato finale via webhook firmato

Come funziona

Come funziona un payout con TransfiYa

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 · TransfiYa:

    Blocca i fondi e invia l’istruzione

    Il payout passa da Locked a In Progress tramite TransfiYa.

  3. 3

    Banca · TransfiYaBeneficiario:

    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

TransfiYa in azione

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

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

Dati chiave

TransfiYa: dati chiave

  • Paese

    Dettaglio
    🇨🇴 Colombia
  • Valuta

    Dettaglio
    COP
  • Direzione

    Dettaglio
    Solo payout
  • TransfiYa

    Dettaglio
    In tempo reale, 24/7 · COP 40 – 50.000.000
  • Chiave Bre-B

    Dettaglio
    In tempo reale, 24/7 · COP 1 – 11.552.000
  • 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 TransfiYa

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

  • Come autorizza il cliente

    Il beneficiario non fa nulla: la tua piattaforma invia il payout con nome, documento e numero di cellulare (TransfiYa) o chiave Bre-B, e il denaro compare sul suo conto o wallet in tempo reale. Se il tuo account richiede approvazione, un secondo utente firma nel Business Portal prima che i fondi partano.

  • Limiti documentati

    TransfiYa (Payout): COP 40 – 50.000.000 · Chiave Bre-B (Payout): COP 1 – 11.552.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 TransfiYa 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.

Storia

Dai bonifici per numero di cellulare a Bre-B

Fonte: Banco de la República, documento tecnico Bre-B, feb. 2026.

  1. Nasce TransfiYa

    La stanza di compensazione interbancaria della Colombia lancia TransfiYa: bonifici in tempo reale tra conti e wallet di istituzioni diverse, indirizzati tramite numero di cellulare.

  2. Regolato come sistema di basso valore

    Con le regole della banca centrale TransfiYa diventa uno dei sistemi di pagamento di basso valore privati (SPBVI) obbligati a interoperare.

  3. Parte di Bre-B

    TransfiYa è uno degli SPBVI attraverso cui vengono instradati i bonifici per chiave di Bre-B, insieme agli altri sistemi privati e pubblici.

  4. 218 partecipanti nell’ecosistema

    A gennaio 2026 l’ecosistema interoperabile conta 218 entità partecipanti e oltre 90 milioni di chiavi registrate.

Perché Localpayment

Perché usare TransfiYa con Localpayment

  • Un’unica API per incassi e payout

    TransfiYa 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

TransfiYa: domande frequenti

Quanto è veloce un payout TransfiYa?

TransfiYa è documentato come metodo di payout in tempo reale. Lo stato del payout passa da Locked a In Progress e il risultato finale arriva tramite webhook firmato.

Qual è l’importo massimo?

Il massimale documentato è COP 50.000.000 per bonifico. Consulta la tabella dei dati chiave e conferma i tuoi limiti con il tuo account manager.

Quali altri circuiti di payout ci sono in Colombia?

Oltre a TransfiYa puoi pagare chiavi Bre-B in tempo reale, 24/7 (fino a COP 11.552.000) e usare ACH per bonifici in giornata o T+1, con cut-off alle 15:00 (ora locale).

Cosa mi serve dal beneficiario per un payout TransfiYa?

Nome, tipo e numero di documento e il numero di cellulare registrato presso banca o wallet. Per un payout a chiave Bre-B passi invece la chiave in beneficiary.bank.account.alias e ometti il numero di conto.

Posso annullare un payout dopo averlo inviato?

Sì, finché è in Pending Authorization, Received, Locked o On Hold. Una volta in In Progress è stato inviato alla rete e non può più essere annullato.

Cosa succede se il conto è chiuso?

Se la banca del beneficiario rifiuta il pagamento dopo il completamento, il payout passa a Returned e i fondi tornano sul tuo saldo Localpayment, con notifica via webhook.

Quando conviene usare ACH?

Per importi oltre i limiti in tempo reale della tabella dei dati chiave, o quando il beneficiario ha solo un numero di conto tradizionale; ACH regola in giornata o T+1 con cut-off alle 15:00.

Invia payout con TransfiYa

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.