Encaissements

Laissez vos clients payer comme on paie déjà sur leur marché.

Proposez au checkout les moyens de paiement locaux pris en charge, recevez la confirmation via les mises à jour de chaque transaction et reliez les fonds encaissés au reste de vos opérations.

Contacter l’équipe commerciale Lire la documentation des encaissements

Un seul endpoint : POST /api/payin/
Devise locale, un seul solde
Webhooks signés pour chaque statut

Pays avec encaissements: 9
Pays avec comptes virtuels: 7
Pays avec cartes : Argentine, Colombie, Mexique et Pérou: 4
Statut en temps réel pour chaque paiement: Webhooks

Le défi

L’encaissement transfrontalier laisse du chiffre d’affaires de côté

Les cartes internationales ne sont qu’une partie du tableau. Dans toute la région, on paie par virement et QR code, et chaque pays le fait à sa manière.

Encaisser sans partenaire local

Uniquement les cartesBeaucoup d’acheteurs préfèrent le virement ou le QR, et abandonnent sans eux.
Une nouvelle intégration par paysChaque marché a ses propres réseaux, documents, plafonds et règles.
Rapprochement manuelRapprocher à la main les paiements de plusieurs prestataires est lent et source d’erreurs.

Encaisser avec Localpayment

Les moyens de paiement déjà utilisésPix, PSE, Bre-B, CVU, CLABE, QR et réseaux de cartes locaux via une seule intégration.
Un seul schéma pour tous les paysLes mêmes champs partout : country, currency, amount, paymentMethod, externalId.
Un solde, un rapport, un format de webhookChaque encaissement est crédité sur votre compte et rapproché dans les mêmes rapports.

Moyens de paiement

Moyens locaux pris en charge, un seul endpoint.

Choisissez les moyens de paiement préférés de chaque marché. La structure de la requête ne change jamais : seuls le code du moyen de paiement, le pays et la devise varient.

Flux de fonds

Du checkout à votre solde

Une requête crée le paiement ; le rail local le confirme ; un webhook signé prévient votre plateforme.

1
ClientVotre plateforme:
1Choisit un moyen local
Pix, SPEI, PSE, Bre-B, cartes ou tout moyen disponible dans le pays.
2
Votre plateformeLocalpayment:
2POST /api/payin/
Montant, devise, pays et données du payeur en une requête.
3
LocalpaymentClient:
3Instructions de paiement
QR code, clé, référence ou redirection, selon le moyen.
4
ClientRail local / banque:
4Paie dans l’app bancaire
Le payeur autorise avec sa propre banque ou son wallet.
5
Rail local / banqueLocalpayment:
5Le rail confirme
Les rails temps réel confirment en quelques secondes ; les autres suivent leurs propres heures limites.
6
LocalpaymentVotre plateforme:
6Webhook signé
Votre système libère la commande et le solde est crédité.

Flux illustratif. Le délai de confirmation et les heures limites dépendent du moyen et du pays.

Fonctionnement

De la requête au solde en quatre étapes

01
Requête
POST /api/payin/ avec le pays (ISO-3), la devise, le montant, le paymentMethod et votre externalId unique.
02
Le client paie
Les cartes sont autorisées en temps réel. Les comptes virtuels et les moyens de paiement locaux sont confirmés de manière asynchrone.
03
Webhook
Un webhook signé HMAC-SHA256 transmet le résultat, votre externalId et notre internalId.
04
Solde crédité
L’encaissement est crédité sur votre compte Localpayment dans votre devise de règlement, généralement l’USD.

Cycle de vie

Gérez tout le cycle de vie du paiement

Tout ce qui se passe après le paiement fonctionne sur la même plateforme, via l’API ou le Business Portal.

Remboursements des paiements par carte, compte virtuel et APM
Gestion des rétrofacturations avec envoi de justificatifs via l’API
Annulation des paiements APM en attente avant validation par le payeur
Téléchargement des justificatifs de paiement pour les remboursements
Checkouts dynamiques avec l’endpoint Get Available Payment Methods
Change au moment du paiement, avec un taux bloqué par jeton de cotation

Découvrir le reporting et le rapprochement

webhooks · livraisons

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

Un seul endpoint, des champs propres à chaque pays.

Authentifiez-vous avec POST /api/token/, puis appelez le même endpoint Create Payin pour n’importe quel pays, avec les champs que ce pays exige. Cet exemple Pix renvoie un QR code et confirme par webhook.

Jetons Bearer : jeton d’accès de 5 minutes, jeton de rafraîchissement de 24 heures
Votre externalId dans chaque requête ; les doublons renvoient HTTP 409
Stage reproduit la production, sans argent réel

Référence de l’API Create Payin

# 1) Obtenez un jeton d’accès (Stage). Conservez les identifiants dans un gestionnaire de secrets.
curl -X POST https://api.stage.localpayment.com/api/token/ \
  -H "Content-Type: application/json" \
  -d '{ "username": "<api-user>", "password": "<from-your-secrets-manager>" }'

# 2) Créez un encaissement Pix (valeurs fictives)
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": "1314", "flow": "DIRECT" },
    "externalId": "7c1e2f7a-0000-4000-8000-000000000001",
    "country": "BRA",
    "currency": "USD",
    "amount": 100,
    "accountNumber": "<your-account-number>",
    "conceptCode": "0003",
    "merchant": { "type": "COMPANY", "name": "Loja Exemplo Ltda" },
    "payer": {
      "type": "INDIVIDUAL",
      "name": "Maria",
      "lastname": "Silva",
      "document": { "type": "CPF", "id": "000.000.000-00" }
    }
  }'

Couverture

Moyens d’encaissement par pays

Argentine
Comptes virtuels
CVU
Cartes
Oui
Moyens locaux
QR · Debin
Bolivie
Comptes virtuels
—
Cartes
—
Moyens locaux
QR
Brésil
Comptes virtuels
Compte virtuel (Pix ou TED)
Cartes
—
Moyens locaux
Pix
Chili
Comptes virtuels
Compte bancaire (TEF)
Cartes
—
Moyens locaux
ETPAY
Colombie
Comptes virtuels
Clé Bre-B
Cartes
Oui
Moyens locaux
PSE
Costa Rica
Comptes virtuels
IBAN (SINPE)
Cartes
—
Moyens locaux
—
Guatemala
Comptes virtuels
—
Cartes
—
Moyens locaux
QR Fri · Wallet Fri
Mexique
Comptes virtuels
CLABE
Cartes
Oui
Moyens locaux
—
Pérou
Comptes virtuels
CCI
Cartes
Oui
Moyens locaux
QR

Pays	Comptes virtuels	Cartes	Moyens locaux
Argentine	CVU	Oui	QR · Debin
Bolivie	—	—	QR
Brésil	Compte virtuel (Pix ou TED)	—	Pix
Chili	Compte bancaire (TEF)	—	ETPAY
Colombie	Clé Bre-B	Oui	PSE
Costa Rica	IBAN (SINPE)	—	—
Guatemala	—	—	QR Fri · Wallet Fri
Mexique	CLABE	Oui	—
Pérou	CCI	Oui	QR

Source : guides pays sur docs.localpayment.com. La disponibilité est confirmée pour chaque marchand lors de l’onboarding.

Cas d’usage

Des encaissements pensés pour chaque secteur

Questions fréquentes

Quelle est ma devise de règlement ?

Généralement l’USD. Les encaissements en devise locale sont crédités sur votre compte Localpayment dans votre devise de règlement. Vous pouvez aussi convertir vos soldes locaux vers d’autres devises fortes, comme l’EUR ou la GBP, pendant les heures du marché local.

Les paiements sont-ils confirmés en temps réel ?

Les autorisations par carte sont en temps réel. Les réseaux temps réel comme Pix, SPEI, COELSA, TEF, CCE et Bre-B confirment en quelques secondes, 24/7. Les autres moyens confirment de manière asynchrone, et chaque statut final arrive par webhook.

Comment savoir qu’un paiement est finalisé ?

Vous recevez un webhook signé HMAC-SHA256 dans l’en-tête X-Signature. Un status.code égal à 200 signifie COMPLETED. Vous pouvez aussi interroger GET /api/transactions/{externalId}/status.

Puis-je rembourser un paiement ?

Oui. Les paiements par carte, compte virtuel et APM peuvent être remboursés via l’API ou le Business Portal.

Faut-il une intégration distincte par pays ?

Non. La structure de la requête est la même partout ; les nouveaux marchés sont activés par configuration, sans nouvelle intégration.

Comment commencer les tests ?

Les identifiants Stage sont fournis dès le début du partenariat. Stage reproduit la production sans argent réel : vous pouvez tester chaque flux avant la mise en production.

Quels moyens de paiement puis-je proposer dans chaque pays ?

Les cartes en Argentine, en Colombie, au Mexique et au Pérou, ainsi que les comptes virtuels et moyens de paiement locaux (APM) lorsqu’ils sont documentés par pays. L’annuaire des moyens de paiement liste chaque méthode, son code et son délai ; votre équipe de compte les active par configuration.

Puis-je encaisser en dollars américains ?

Sur certains marchés, oui : par exemple des comptes virtuels en USD au Costa Rica, au Pérou et au Mexique (via SPID). Dans la plupart des pays, le payeur règle en monnaie locale et l’encaissement est crédité sur votre compte dans votre devise de règlement.

Laissez vos clients payer comme on paie déjà sur leur marché.

L’encaissement transfrontalier laisse du chiffre d’affaires de côté

Encaisser sans partenaire local

Encaisser avec Localpayment

Moyens locaux pris en charge, un seul endpoint.

Cartes

Comptes virtuels

Moyens de paiement locaux (APM)

Abonnements

Du checkout à votre solde

De la requête au solde en quatre étapes

Requête

Le client paie

Webhook

Solde crédité

Gérez tout le cycle de vie du paiement

Un seul endpoint, des champs propres à chaque pays.

Moyens d’encaissement par pays

Des encaissements pensés pour chaque secteur

E-commerce & marketplaces

Biens numériques & streaming

SaaS

Voyage

Questions fréquentes

Aussi sur la même API

Comptes virtuels

Décaissements

Rapprochement et reporting

Commencez à encaisser localement

Téléchargez votre exemplaire