Moyens de paiement locaux
Faites une place aux moyens de paiement pour lesquels vos clients ouvrent déjà leur appli bancaire.
Virements de compte à compte et QR codes validés dans la banque en ligne ou l’application du payeur, plus Wallet Fri au Guatemala. Aucune donnée de carte à collecter, et chaque statut final arrive par webhook signé.
- Pix · PSE · Debin · ETPAY
- QR dans 4 pays et Wallet Fri
- Le même endpoint Create Payin
Pix · PSE · Debin · ETPAY- Paiements de compte à compte au Brésil et en Colombie
- Pix · PSE
- Pays avec paiements QR : Argentine, Bolivie, Guatemala et Pérou
- 4
- Paiements bancaires en Argentine et au Chili
- Debin · ETPAY
- Paiements par portefeuille au Guatemala
- Wallet Fri
Moyens de paiement
Réseaux A2A, QR et portefeuilles, marché par marché
Chaque moyen de paiement suit les règles et plafonds locaux. Votre intégration reste la même.
A2A
- br
- co
- ar
- cl
Pix au Brésil, PSE en Colombie, Debin en Argentine et ETPAY au Chili. Le payeur valide auprès de sa propre banque.
A2A —QR
- ar
- bo
- gt
- pe
QR codes en Argentine, en Bolivie, au Guatemala (QR Fri) et au Pérou. Le payeur scanne et valide dans son application bancaire ou de portefeuille.
QR —Wallets
- gt
Wallet Fri au Guatemala. Le payeur reçoit une notification push dans l’application Wallet Fri et y autorise le paiement ; le statut final arrive par webhook.
Wallets —
br
co
ar
cl
bo
gt
peFonctionnement
Quatre étapes, un seul endpoint
- 01
Créez l’encaissement
Appelez POST /api/payin/ et choisissez le code du moyen de paiement, par exemple 1314 pour Pix ou 1936 pour PSE.
- 02
Affichez le QR ou redirigez
Affichez le QR code ou les instructions de paiement, ou envoyez le payeur vers le parcours bancaire pour PSE.
- 03
Le payeur valide
La validation se fait dans la banque en ligne ou l’application du payeur. Aucune donnée de carte ne transite par votre checkout.
- 04
Statut par webhook
Le statut final arrive de manière asynchrone, signé HMAC-SHA256.
Répertoire
Moyens de paiement locaux par pays
Moyens A2A et QR, plus Wallet Fri, documentés à ce jour.
Argentine
- Moyens locaux
- QR · Debin
Bolivie
- Moyens locaux
- QR
Brésil
- Moyens locaux
- Pix
Chili
- Moyens locaux
- ETPAY
Colombie
- Moyens locaux
- PSE
Guatemala
- Moyens locaux
- QR Fri · Wallet Fri
Pérou
- Moyens locaux
- QR
Source : guides pays sur docs.localpayment.com. En Colombie, Bre-B est encaissé via des comptes virtuels (clé Bre-B). La disponibilité est confirmée pour chaque marchand lors de l’onboarding.
Opérations
Asynchrone par conception, rapproché comme tout le reste
Les moyens de paiement locaux confirment lorsque le payeur valide, et non lorsque vous envoyez la requête. Nous suivons l’attente et vous notifions une seule fois, avec un statut final signé.
- Webhooks signés avec X-Signature : HMAC-SHA256
- Annulation des paiements en attente avant validation par le payeur
- Remboursements des paiements APM
- Un seul format de rapport, avec les cartes et les comptes virtuels
- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }Pour les développeurs
Ajoutez PSE avec la même requête
Changez le pays, la devise et le paymentMethod.code : le reste de la requête ne change pas. PSE utilise un parcours par redirection, et la réponse inclut l’URL du portail bancaire du payeur.
- Pix 1314 · PSE 1936 · chaque moyen de paiement est sélectionné par son code
- Get Available Payment Methods pour construire un checkout dynamique
- Annulez les paiements en attente ou remboursez via l’API
# Exemple illustratif — PSE (Colombie), champs simplifiés ; voir 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"
}
}'Cas d’usage
Là où les moyens de paiement locaux font la différence
E-commerce et marketplaces
Proposez Pix, PSE et QR à côté des cartes pour que davantage d’acheteurs paient comme ils le souhaitent.
E-commerce et marketplaces —Biens numériques et gaming
Confirmation rapide des recharges et achats in-game, sans carte.
Biens numériques et gaming —Fintech et portefeuilles
Permettez aux utilisateurs de recharger leur solde depuis leur application bancaire, en quelques secondes sur des réseaux temps réel comme Pix.
Fintech et portefeuilles —Voyage
Encaissez les réservations en devise locale avec des moyens de paiement bancaires natifs.
Voyage —
Questions fréquentes
Qu’est-ce qu’un APM ?
Les moyens de paiement alternatifs sont des réseaux locaux natifs du système bancaire : virements bancaires instantanés, schémas QR et flux de compte à compte. Le payeur finalise le paiement dans son application bancaire ou de wallet, sans saisir de données de carte.
En combien de temps les paiements sont-ils confirmés ?
Pix confirme en quelques secondes, 24/7. Les APM sont asynchrones : le payeur valide en dehors de votre checkout, et chaque statut final arrive par webhook.
Puis-je annuler ou rembourser un paiement APM ?
Oui. Les paiements en attente peuvent être annulés avant la validation du payeur, et les paiements APM finalisés peuvent être remboursés.
Combien de temps une demande Debin est-elle valable ?
En Argentine, les demandes Debin expirent au bout de deux jours si le payeur ne les valide pas.
Faut-il une nouvelle intégration pour chaque moyen de paiement ?
Non. Tous les moyens de paiement utilisent le même endpoint Create Payin ; vous changez le code du moyen de paiement, le pays et la devise.
Comment le payeur finalise-t-il un paiement APM ?
Selon le moyen, il est redirigé vers sa banque (PSE), scanne un QR code ou valide une demande dans son application bancaire ou dans Wallet Fri. La page des expériences de checkout montre chaque parcours écran par écran.
Dans quelle devise le paiement est-il effectué ?
Dans la devise locale de chaque pays — par exemple BRL pour Pix, COP pour PSE et CLP pour ETPAY — puis crédité sur votre compte Localpayment dans votre devise de règlement.
Aussi sur la même API
Encaissements
Cartes, comptes virtuels, moyens locaux et abonnements via un seul endpoint Create Payin.
Encaissements —Comptes virtuels
Un numéro de compte local dédié pour chaque client ou facture.
Comptes virtuels —Décaissements
Des paiements vers des portefeuilles ? Envoyez des fonds vers Yape, SINPE Móvil, les portefeuilles CCE et plus encore.
Décaissements —Annuaire des moyens de paiement
Chaque méthode documentée, avec codes, limites et délais par pays.
Annuaire des moyens de paiement —Parcours de paiement
Découvrez chaque moyen de paiement tel que le voit le payeur, écran par écran.
Parcours de paiement —Démarrage rapide développeurs
Obtenez un jeton, envoyez votre première requête et recevez un webhook sur Stage.
Démarrage rapide développeurs —
Proposez les moyens de paiement préférés en Amérique latine
Identifiez avec notre équipe paiements les bons moyens de paiement locaux pour chacun de vos marchés.