Encaissements

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

Acceptez cartes, comptes virtuels, Pix, PSE, Bre-B et QR en devise locale là où ils sont proposés via une seule intégration, et réglez chaque encaissement sur un solde unique.

Contacter l’équipe commerciale Lire la documentation des encaissements

Encaissements là où ils sont proposés
Une intégration pour tous les marchés
Devise locale, un seul solde

Pix · PSE
Encaissements locaux via une API: Pix · SPEI
Rails de paiement locaux, en temps réel, 24 h/24: Pix · SPEI
Rails de paiement locaux, en temps réel, 24 h/24: Webhooks
Statut en temps réel pour chaque paiement

Pourquoi Localpayment

Encaissez plus, intégrez une fois, rapprochez moins

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.

Les moyens de paiement déjà utilisés
Pix, PSE, Bre-B, CVU, CLABE, QR et cartes via une seule intégration, pour que les acheteurs qui préfèrent le virement ou le QR n’abandonnent pas.
Une intégration pour tous les marchés
Chaque marché a ses propres réseaux, documents, plafonds et règles. Avec Localpayment, la requête est la même partout et les nouveaux marchés s’activent par configuration.
Confirmation en quelques secondes
Les autorisations par carte sont en temps réel, et les réseaux temps réel comme Pix, SPEI, TEF, CCE et Bre-B confirment en quelques secondes, 24/7.
Un solde, un rapport
Chaque encaissement est crédité sur votre compte Localpayment dans votre devise de règlement, généralement l’USD, et rapproché dans les mêmes rapports, sans rapprochement manuel entre prestataires.
Un solde, un rapport —

Cas d’usage

Des encaissements pensés pour chaque secteur

Moyens de paiement

Moyens locaux pris en charge, un seul endpoint.

Choisissez les moyens de paiement préférés de chaque marché : votre intégration reste la même dans chaque 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
Le client reçoit un QR code, une clé, une référence ou une redirection, selon le moyen. 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.

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.

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" }
    }
  }'

// Node.js 18+ (built-in fetch) · Stage · fictitious values
const BASE_URL = 'https://api.stage.localpayment.com';

// 1) Obtenez un jeton d’accès (Stage). Conservez les identifiants dans un gestionnaire de secrets.
const tokenRes = await fetch(`${BASE_URL}/api/token/`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    username: process.env.LP_API_USER,
    password: process.env.LP_API_PASSWORD,
  }),
});
const { access } = await tokenRes.json();

// 2) Créez un encaissement Pix (valeurs fictives)
const res = await fetch(`${BASE_URL}/api/payin/`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${access}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    paymentMethod: { type: 'BankTransfer', code: '1314', flow: 'DIRECT' },
    externalId: crypto.randomUUID(),
    country: 'BRA',
    currency: 'USD',
    amount: 100,
    accountNumber: process.env.LP_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' },
    },
  }),
});
const payin = await res.json();
// Affichez payin.qr.code (Pix Copia e Cola) à votre client ; le statut final arrive par webhook.

{
  "transactionType": "PayIn",
  "externalId": "7c1e2f7a-0000-4000-8000-000000000001",
  "internalId": "b4c1d2e3-0000-4000-8000-00000000abcd",
  "paymentMethod": { "type": "BankTransfer", "code": "1314", "flow": "DIRECT" },
  "country": "BRA",
  "currency": "USD",
  "amount": 100,
  "payment": { "currency": "BRL", "fxQuote": 5.0, "amount": 500.00 },
  "status": { "code": "100", "description": "INPROGRESS", "detail": "The payin is pending the confirmation" },
  "qr": { "code": "<pix-emv-code>", "expirationDate": "2026-10-01T12:00:00-03:00" },
  "errors": []
}

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

Encaissez plus, intégrez une fois, rapprochez moins

Les moyens de paiement déjà utilisés

Une intégration pour tous les marchés

Confirmation en quelques secondes

Un solde, un rapport

Parlez à notre équipe commerciale

Des encaissements pensés pour chaque secteur

E-commerce & marketplaces

Biens numériques & streaming

SaaS

Voyage

Moyens locaux pris en charge, un seul endpoint.

Cartes

Comptes virtuels

Moyens de paiement locaux (APM)

Abonnements

De la requête au solde en quatre étapes

Requête

Le client paie

Webhook

Solde crédité

Moyens d’encaissement par pays

Gérez tout le cycle de vie du paiement

Un seul endpoint, des champs propres à chaque pays.

Questions fréquentes

Aussi sur la même API

Comptes virtuels

Décaissements

Rapprochement et reporting

Commencez à encaisser localement

Téléchargez votre exemplaire