Vai al contenuto

Metodi di pagamento · Brasile

Pix in Brasile: pagamenti istantanei, in entrata e in uscita

Incassa con QR code o Copia e Cola, assegna chiavi Pix ai tuoi clienti e paga i beneficiari in tempo reale, 24/7, con un’unica integrazione.

Contatta le venditeVai alla documentazione
  • Bonifico istantaneo
  • Brasile
  • Incasso · Payout

Dati chiave

Pix su scala nazionale

Dati pubblicati dalla Banca Centrale del Brasile.

Che cos’è

Il circuito di pagamento istantaneo del Brasile

Pix è il sistema di pagamento istantaneo creato dalla Banca Centrale del Brasile. Il pagatore approva nell’app della sua banca e il denaro passa tra i conti in pochi secondi, a qualsiasi ora. Con Localpayment lo usi in tre modi: come metodo di pay-in, come conto virtuale identificato da una chiave Pix e come circuito di payout.

  • Pay-in con QR code o Copia e Cola, confermato via webhook
  • Conto virtuale con chiave Pix (e-mail, telefono o chiave casuale) che riceve anche TED
  • Payout Pix in tempo reale, 24/7, e TED per bonifici in giornata o T+1

Come funziona

Come funziona un pagamento con Pix

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

  1. 1

    ClienteLa tua azienda:

    Sceglie Pix

    Nel tuo checkout o tramite un link di pagamento.

  2. 2

    La tua aziendaLocalpayment:

    Crea il pay-in

    POST /api/payin/ con paese, valuta, importo e dati del pagatore. La risposta include l’immagine del QR Pix e il codice Copia e Cola, con data di scadenza. Stato 100 (INPROGRESS).

  3. 3

    ClienteBanca · Pix:

    Approva nell’app della banca o del wallet

    Il pagatore scansiona il QR o incolla il codice nell’app della banca e conferma il pagamento.

  4. 4

    LocalpaymentLa tua azienda:

    Webhook con lo stato finale

    Localpayment riceve la conferma e aggiorna la transazione. Firmato con HMAC-SHA256 (x-Signature). Lo stato 200 indica completato; deduplica su externalId.

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

Come funziona

Come funziona un payout con Pix

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

    Blocca i fondi e invia l’istruzione

    Il payout passa da Locked a In Progress tramite Pix.

  3. 3

    Banca · PixBeneficiario:

    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

Pix in azione

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

  1. 1PixAl pagatore viene mostrato un QR code (o un codice da copiare).
  2. 2Banco EjemploIl pagatore verifica BRL 249,90 e approva nell’app della banca o del wallet.
  3. 3Pagamento confermatoIl tuo sistema riceve il webhook firmato e rilascia l’ordine.
Contatta le vendite

Dati chiave

Pix: dati chiave

  • Paese

    Dettaglio
    🇧🇷 Brasile

  • Valuta

    Dettaglio
    BRL

  • Direzione

    Dettaglio
    Incasso e payout

  • Incasso · Pix (QR e Copia e Cola)

    Dettaglio
    In tempo reale, confermato via webhook · BRL 0,01 – 1.000.000

  • Incasso · Conto virtuale (Pix or TED)

    Dettaglio
    In tempo reale, confermato via webhook · BRL 0,01 – 2.000.000

  • Payout · Pix

    Dettaglio
    In tempo reale, 24/7 · Min. BRL 0,06, senza importo massimo

  • Payout · Bonifico bancario (TED)

    Dettaglio
    In giornata o T+1, cut-off alle 17:00 (ora di Brasília)

  • Regolamento dei payout

    Dettaglio
    In tempo reale, 24/7, inclusi weekend e festivi

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 Pix

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 cliente scansiona il QR con l’app della banca o del wallet, oppure incolla il codice Copia e Cola nel campo “Paga con codice Pix”, verifica l’importo e conferma. La risposta include una data di scadenza; mostra un conto alla rovescia e crea un nuovo pay-in se scade.

  • Limiti documentati

    Pix (QR e Copia e Cola) (Incasso): BRL 0,01 – 1.000.000 · Conto virtuale (Pix or TED) (Incasso): BRL 0,01 – 2.000.000 · Pix (Payout): Min. BRL 0,06, senza importo massimo. Per transazione, secondo la documentazione pubblicata; i limiti contrattuali possono variare.

  • Rimborsi e resi

    Un pay-in completato si rimborsa con PATCH /api/payin/{externalId}/refund. Sono supportati solo rimborsi totali; il denaro torna su un conto bancario del pagatore e la transazione termina nello stato 902 (REFUNDED). Finché il pagamento è in sospeso può invece essere annullato.

Checklist di integrazione

Vai in produzione con Pix 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. Crea il pay-in

    POST /api/payin/ con il codice Localpayment della tabella dei dati chiave, paese ISO-3, valuta, importo e dati del pagatore.

  3. Mostra le istruzioni

    Mostra il QR, il codice, il reindirizzamento o i dati del conto della risposta e rispetta la data di scadenza.

  4. Verifica il webhook

    Valida x-Signature (HMAC-SHA256), rilascia l’ordine allo stato 200 e deduplica su externalId.

  5. Guarda il checkout animato

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

Storia

Come Pix è diventato il modo abituale di pagare

Fonte: Banco Central do Brasil, Relatório de Gestão do Pix 2023–2025.

  1. Lancio

    La Banca Centrale del Brasile lancia Pix sulla sua infrastruttura SPI: bonifici istantanei tra qualsiasi conto, 24/7, indirizzati tramite chiavi.

  2. Prelievo contanti e funzioni per i commercianti

    Pix Saque e Pix Troco permettono di prelevare contanti nei negozi; il QR dinamico e il Copia e Cola rendono Pix un metodo di checkout.

  3. Pix Automático

    I pagamenti ricorrenti entrano in funzione il 16 giugno 2025, insieme a Pix Agendado, Pix contactless e all’iniziazione di pagamento Open Finance.

  4. Quasi 80 miliardi di transazioni

    Pix elabora 79,8 miliardi di transazioni nell’anno, il 43% da persona a impresa, con oltre 920 milioni di chiavi registrate.

Perché Localpayment

Perché usare Pix con Localpayment

  • Un’unica API per incassi e payout

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

Continua a esplorare

FAQ

Pix: domande frequenti

Quanto velocemente viene confermato un pagamento Pix?

Pix è un circuito in tempo reale che conferma in pochi secondi, 24/7. Per i pay-in lo stato finale arriva tramite webhook firmato: costruisci il flusso degli ordini su questa notifica.

Quali sono i limiti?

L’intervallo documentato per i pay-in va da BRL 0,01 a 1.000.000 per transazione. I payout Pix partono da BRL 0,06 e non hanno un massimale documentato. Consulta la tabella dei dati chiave e conferma i tuoi limiti con il tuo account manager.

Posso fare payout sia con Pix sia con TED?

Sì. I payout Pix sono in tempo reale, 24/7. È disponibile anche il TED per bonifici in giornata o T+1, con cut-off alle 17:00 (ora di Brasília).

Quali tipi di chiave Pix può usare un conto virtuale?

Un conto virtuale Localpayment in Brasile include una chiave Pix (e-mail, telefono o chiave casuale) e i dati di banca, agenzia e conto, restituiti alla creazione. Il pagatore invia un Pix alla chiave, oppure un Pix o un TED ai dati del conto: entrambi i circuiti accreditano lo stesso conto e attivano lo stesso webhook.

Posso rimborsare parzialmente un pagamento Pix?

No. I rimborsi Pix tramite Localpayment sono solo totali e si richiedono con PATCH /api/payin/{externalId}/refund su una transazione completata. Il denaro torna al pagatore e il pay-in termina nello stato 902 (REFUNDED).

Pix ha i chargeback?

Pix è un pagamento push autorizzato dal pagatore nell’app della propria banca, quindi non esiste il chargeback in stile carta. Le contestazioni si gestiscono con rimborsi avviati da te.

Il QR code scade?

Sì. Ogni risposta di pay-in include qr.expirationDate. Mostra un conto alla rovescia nel checkout e, alla scadenza, crea un nuovo pay-in invece di riutilizzare il vecchio codice.

Aggiungi Pix ai tuoi incassi

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

Contatta le venditeVai alla documentazione

Come possiamo aiutarti?

Scarica la tua copia

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