Vai al contenuto

Metodi di pagamento locali

Fai spazio ai metodi di pagamento per cui i clienti aprono già la loro app bancaria.

Bonifici account-to-account e codici QR approvati nell’home banking o nell’app del pagatore, più Wallet Fri in Guatemala. Nessun dato di carta da raccogliere, e ogni stato finale arriva tramite webhook firmato.

Parla con il team commercialeDocumentazione APM
  • Pix · PSE · Debin · ETPAY
  • QR in 4 paesi e Wallet Fri
  • Lo stesso endpoint Create Payin
Copertura
CanadaArgentinaCileRepubblica DominicanaMessicoUruguayBrasileBoliviaPerùColombiaPanamaCosta RicaNicaraguaHondurasEl SalvadorGuatemalaEcuadorParaguay
Pagamenti account-to-account in Brasile e Colombia
Pix · PSE
Paesi con pagamenti QR: Argentina, Bolivia, Guatemala e Perù
4
Pagamenti bancari in Argentina e Cile
Debin · ETPAY
Pagamenti con wallet in Guatemala
Wallet Fri

Metodi

Circuiti A2A, QR e wallet, mercato per mercato

Ogni metodo segue regole e limiti locali. La tua integrazione resta la stessa.

Come funziona

Quattro passaggi, un unico endpoint

  1. 01

    Crea l’incasso

    Chiama POST /api/payin/ e scegli il codice del metodo, ad esempio 1314 per Pix o 1936 per PSE.

  2. 02

    Mostra il QR o reindirizza

    Mostra il codice QR o le istruzioni di pagamento, oppure invia il pagatore al flusso bancario per PSE.

  3. 03

    Il pagatore approva

    L’approvazione avviene nell’home banking o nell’app del pagatore. Nessun dato di carta passa dal tuo checkout.

  4. 04

    Stato via webhook

    Lo stato finale arriva in modo asincrono, firmato con HMAC-SHA256.

Elenco

Metodi locali per paese

Metodi A2A e QR, più Wallet Fri, documentati oggi.

  • Argentina

    Metodi locali
    QR · Debin

  • Bolivia

    Metodi locali
    QR

  • Brasile

    Metodi locali
    Pix

  • Cile

    Metodi locali
    ETPAY

  • Colombia

    Metodi locali
    PSE

  • Guatemala

    Metodi locali
    QR Fri · Wallet Fri

  • Perù

    Metodi locali
    QR

Fonte: guide per paese su docs.localpayment.com. In Colombia, Bre-B si incassa tramite conti virtuali (chiave Bre-B). La disponibilità viene confermata per ogni merchant durante l’onboarding.

Operatività

Asincrono per progettazione, riconciliato come tutto il resto

I metodi locali confermano quando il pagatore approva, non quando invii la richiesta. Noi monitoriamo l’attesa e ti avvisiamo una sola volta, con uno stato finale firmato.

  • Webhook firmati con X-Signature: HMAC-SHA256
  • Annullamento dei pagamenti in sospeso prima dell’approvazione del pagatore
  • Rimborsi per i pagamenti APM
  • Un unico formato di report insieme a carte e conti virtuali
Webhook per sviluppatori

Per sviluppatori

Aggiungi PSE con la stessa richiesta

Cambia paese, valuta e paymentMethod.code: il resto della richiesta rimane uguale. PSE usa un flusso con reindirizzamento e la risposta include l’URL del portale bancario del pagatore.

  • Pix 1314 · PSE 1936 · ogni metodo si seleziona con il suo codice
  • Get Available Payment Methods per creare un checkout dinamico
  • Annulla i pagamenti in sospeso o rimborsa tramite API
Leggi la documentazione APM
# Esempio illustrativo: PSE (Colombia), campi semplificati; vedi docs.localpayment.com
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": "1936", "flow": "REDIRECT" },
    "externalId": "c2b8e6d4-0000-4000-8000-000000000019",
    "country": "COL",
    "currency": "COP",
    "amount": 350000,
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A.S.", "merchantId": "<your-merchant-id>" },
    "payer": {
      "type": "INDIVIDUAL",
      "name": "Camila",
      "lastname": "Rojas",
      "document": { "type": "CC", "id": "1000000000" },
      "email": "camila.rojas@example.com"
    }
  }'

Casi d’uso

Dove i metodi locali fanno la differenza

Domande frequenti

Che cos’è un APM?

I metodi di pagamento alternativi sono circuiti locali nativi del sistema bancario: bonifici istantanei, schemi QR e flussi account-to-account. Il pagatore completa il pagamento nella propria app bancaria o wallet, senza inserire dati di carta.

In quanto tempo vengono confermati i pagamenti?

Pix conferma in pochi secondi, 24/7. Gli APM sono asincroni: il pagatore approva fuori dal tuo checkout e ogni stato finale arriva via webhook.

Posso annullare o rimborsare un pagamento APM?

Sì. I pagamenti in sospeso possono essere annullati prima dell’approvazione del pagatore e i pagamenti APM completati possono essere rimborsati.

Per quanto tempo è valida una richiesta Debin?

In Argentina le richieste Debin scadono dopo due giorni se il pagatore non le approva.

Mi serve una nuova integrazione per ogni metodo?

No. Tutti i metodi usano lo stesso endpoint Create Payin; cambi il codice del metodo, il paese e la valuta.

Come completa il pagatore un pagamento APM?

A seconda del metodo, viene reindirizzato alla sua banca (PSE), scansiona un codice QR o approva una richiesta nella sua app bancaria o in Wallet Fri. La pagina delle esperienze di checkout mostra ogni flusso schermata per schermata.

In quale valuta avviene il pagamento?

Nella valuta locale di ogni paese (ad esempio BRL per Pix, COP per PSE e CLP per ETPAY) e viene accreditato sul tuo conto Localpayment nella tua valuta di regolamento.

Anche sulla stessa API

Offri i metodi preferiti in America Latina

Individua con il nostro team pagamenti i metodi locali giusti per ciascuno dei tuoi mercati.

Contatta le venditeLeggi la documentazione APM

Come possiamo aiutarti?

Scarica la tua copia

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