Cartes

Acceptez les paiements par carte avec un parcours de paiement pensé pour chaque marché.

Acceptez Visa et Mastercard en Argentine, en Colombie, au Mexique et au Pérou, ainsi qu’American Express et Diners Club là où c’est documenté. Tokenisez les cartes enregistrées, authentifiez avec 3D Secure, proposez le paiement échelonné et gérez les rétrofacturations via une seule intégration.

Contacter l’équipe commerciale Documentation cartes

PCI DSS v4.0.1
SOC 2 Type II
ISO 27001
AML/KYC
TLS 1.2+ · AES-256

Argentine · Colombie · Mexique · Pérou
Visa, Mastercard, Amex, Diners
PEN et USD au Pérou

Pix · SPEI
Rails de paiement locaux, en temps réel, 24 h/24: 4
Marques de cartes : Visa, Mastercard, Amex et Diners: 3D Secure
En Colombie, au Mexique et au Pérou: Paiement échelonné
En Colombie, au Mexique et au Pérou

Pourquoi Localpayment

Convertissez plus de paiements par carte, avec moins de risque

Des achats répétés plus rapides
Remplacez les données de carte par un jeton sur les quatre marchés : les clients récurrents paient plus vite et les abonnements sont débités sur la carte enregistrée.
Des paniers plus élevés grâce à l’échelonnement
Laissez vos clients payer en plusieurs fois par carte de crédit, en monnaie locale, en Colombie, au Mexique et au Pérou.
Moins de fraude
3D Secure en Colombie, au Mexique et au Pérou, liste blanche de BIN et gestion des rétrofacturations bloquent les transactions frauduleuses avant qu’elles ne deviennent des rétrofacturations.
Un périmètre PCI réduit
Smart Fields, l’iframe intégré et WebCheckout capturent les données de carte dans des champs que nous hébergeons : elles ne transitent jamais par vos serveurs.
Un périmètre PCI réduit —

Réseaux

Les réseaux internationaux que les acheteurs utilisent déjà

Visa et Mastercard sur les quatre marchés, plus American Express et Diners Club en Argentine et en Colombie, en crédit comme en débit.

Cas d’usage

Programmes cartes par secteur

Fonctionnement

Le parcours d’un paiement par carte

01
Saisie
Le client saisit ses données de carte dans Smart Fields ou un checkout hébergé, ou vous réutilisez un jeton enregistré.
02
Autorisation
Appelez POST /api/payin/ avec paymentMethod.type CreditCard et le code de la marque pour le pays.
03
Authentification si nécessaire
Si l’émetteur demande 3D Secure, redirigez le client vers l’URL de challenge indiquée dans la réponse.
04
Confirmation
Le résultat arrive en temps réel et par webhook signé, prêt pour l’exécution de la commande et le rapprochement.

Marché par marché

Ce qui est disponible dans chaque pays

Les fonctionnalités cartes varient selon le marché. Voici ce que couvre la documentation à ce jour.

Argentine
Paiement ponctuel
✓
Tokenisation
✓
Remboursements
✓
Rétrofacturations
✓
3DS
—
Paiement échelonné
—
Abonnements
—
Colombie
Paiement ponctuel
✓
Tokenisation
✓
Remboursements
✓
Rétrofacturations
✓
3DS
✓
Paiement échelonné
✓
Abonnements
✓
Mexique
Paiement ponctuel
✓
Tokenisation
✓
Remboursements
✓
Rétrofacturations
✓
3DS
✓
Paiement échelonné
✓
Abonnements
✓
Pérou
Paiement ponctuel
✓
Tokenisation
✓
Remboursements
✓
Rétrofacturations
✓
3DS
✓
Paiement échelonné
✓
Abonnements
✓

Pays	Paiement ponctuel	Tokenisation	Remboursements	Rétrofacturations	3DS	Paiement échelonné	Abonnements
Argentine	✓	✓	✓	✓	—	—	—
Colombie	✓	✓	✓	✓	✓	✓	✓
Mexique	✓	✓	✓	✓	✓	✓	✓
Pérou	✓	✓	✓	✓	✓	✓	✓

Source : docs.localpayment.com. Les cartes ne sont pas proposées au Brésil ; utilisez plutôt Pix et les comptes virtuels à clé Pix.

Fonctionnalités

Tout ce dont l’acceptation des cartes a besoin

Des contrôles à plusieurs niveaux vous aident à bloquer les transactions frauduleuses avant qu’elles ne deviennent des rétrofacturations.

3D Secure
Authentifiez les porteurs de carte en Colombie, au Mexique et au Pérou. Lorsque l’émetteur demande un challenge, l’API renvoie l’URL du challenge.
Liste blanche de BIN
Limitez l’acceptation aux BIN préapprouvés, par émetteur et type de carte, depuis le Business Portal.
Gestion des rétrofacturations
Recevez un webhook pour chaque rétrofacturation et transmettez vos justificatifs via l’API ou le Business Portal avant l’échéance.
Paiement échelonné
Calculez un plan d’échéances, laissez le client choisir et débitez — sur les cartes de crédit en monnaie locale en Colombie, au Mexique et au Pérou (PEN uniquement).
Pré-autorisation et capture
Autorisez maintenant et capturez plus tard, ou libérez la réservation si la commande n’aboutit pas. La disponibilité par marché est confirmée lors de l’onboarding.
Remboursements
Remboursez les paiements par carte depuis l’API ou le Business Portal et téléchargez le justificatif de paiement.

Périmètre PCI

Gardez les données de carte hors de vos serveurs

Collectez les cartes avec Smart Fields, l’iframe intégrée ou WebCheckout. Les données de carte sont saisies dans des champs que nous hébergeons, puis transformées en un jeton que votre backend envoie avec l’encaissement.

Smart Fields : champs de carte hébergés dans votre propre interface, via un SDK JS
Iframe intégrée : un checkout en marque blanche avec un périmètre PCI réduit
WebCheckout et liens de paiement : sans code et avec un périmètre PCI minimal
TLS 1.2+ en transit, AES-256 au repos et rotation des clés avec AWS KMS

Découvrir Checkout et Smart Fields

POST /api/payin/

curl -X POST https://api.v3.localpayment.com/api/payin/
  -H "Authorization: Bearer $ACCESS_TOKEN"
  -d '{
    "externalId": "order-8f2k-1043",
    "paymentMethod": { "type": "BankTransfer", "code": "1314" },
    "country": "BRA", "currency": "BRL",
    "amount": 1250.00
  }'

Playground API

Encaissez une carte tokenisée

POST /api/payin/ avec un jeton de carte au Mexique (Visa, code 1600). Entrée montre 103 APPROVED, puis le webhook de crédit.

DEMODONNÉES ILLUSTRATIVES

La barre 80/20 est une répartition illustrative du storyboard.

Soldes illustratifs

USD25,000.00
ARS250,000.00
BRL184,200.00
MXN310,500.00

Les soldes ne bougent que dans cette démo, selon les montants d’exemple.

uspapesv

USD dans cette démo : États-Unis, Panama, Pérou et Salvador.

localpayment — demo

POST /api/payin/

Authorization: Bearer <DEMO_TOKEN>

DEMO · Rien n’est envoyé. Cette démo n’appelle ni Stage ni la production.

POST /api/payin/

La réponse simulée s’affiche ici

Voir la documentationDONNÉES ILLUSTRATIVES

Pour les développeurs

Débitez une carte tokenisée

Envoyez le jeton au lieu des données de carte, et réutilisez-le pour les débits ultérieurs.

Codes de marque par pays — par exemple 1600 pour Visa au Mexique
Cartes de test Stage pour les autorisations, les refus et 3D Secure
Webhooks pour les autorisations, les remboursements et les rétrofacturations

Guide des paiements par carte

# Exemple illustratif — champs simplifiés ; consultez docs.localpayment.com pour le contrat complet
curl -X POST https://api.stage.localpayment.com/api/payin/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethod": { "type": "CreditCard", "code": "1600", "flow": "DIRECT" },
    "externalId": "3f9a6c1e-0000-4000-8000-000000000042",
    "country": "MEX",
    "currency": "MXN",
    "amount": 1250.00,
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A. de C.V." },
    "payer": {
      "type": "INDIVIDUAL",
      "name": "Lucía",
      "lastname": "Méndez",
      "document": { "type": "RFC", "id": "XAXX010101000" },
      "email": "lucia.mendez@example.com"
    },
    "card": { "token": "<card-token>" }
  }'

// Exemple illustratif — champs simplifiés ; consultez docs.localpayment.com pour le contrat complet
const res = await fetch('https://api.stage.localpayment.com/api/payin/', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${accessToken}`, // from POST /api/token/
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    paymentMethod: { type: 'CreditCard', code: '1600', flow: 'DIRECT' }, // Visa · Mexico
    externalId: crypto.randomUUID(),
    country: 'MEX',
    currency: 'MXN',
    amount: 1250.0,
    accountNumber: process.env.LP_ACCOUNT_NUMBER,
    conceptCode: '0001',
    merchant: { type: 'COMPANY', name: 'Comercio Ejemplo S.A. de C.V.' },
    payer: {
      type: 'INDIVIDUAL',
      name: 'Lucía',
      lastname: 'Méndez',
      document: { type: 'RFC', id: 'XAXX010101000' },
      email: 'lucia.mendez@example.com',
    },
    card: { token: storedCardToken }, // jeton issu de POST /api/card ou de Smart Fields
  }),
});
const payin = await res.json(); // status.description: APPROVED, REJECTED…

Questions fréquentes

Les cartes sont-elles disponibles au Brésil ?

Non. L’acceptation des cartes couvre l’Argentine, la Colombie, le Mexique et le Pérou. Au Brésil, encaissez avec Pix et les comptes virtuels à clé Pix, qui confirment en quelques secondes, 24/7.

Quelles marques de cartes puis-je accepter ?

Visa et Mastercard sur les quatre marchés, plus American Express et Diners Club en Argentine et en Colombie. Les cartes de débit sont prises en charge sur les quatre marchés.

Où 3D Secure, le paiement échelonné et les abonnements sont-ils disponibles ?

En Colombie, au Mexique et au Pérou. Le paiement échelonné s’applique aux cartes de crédit en monnaie locale ; au Pérou, il ne concerne donc que les paiements en PEN. En Argentine, vous pouvez utiliser les paiements ponctuels, la tokenisation, les remboursements et la gestion des rétrofacturations.

Comment fonctionnent les rétrofacturations ?

Vous recevez un webhook de rétrofacturation et pouvez envoyer vos justificatifs via l’API ou le Business Portal avant la date limite indiquée dans la notification. Sans justificatif dans les délais, le litige est généralement tranché en faveur du porteur de carte.

Puis-je tester les flux cartes avant la mise en production ?

Oui. Stage fournit des cartes de test pour les autorisations, les refus, les challenges 3D Secure et les erreurs de traitement, sans argent réel.

Comment les données de carte sont-elles protégées ?

Les données sont chiffrées avec TLS 1.2+ en transit et AES-256 au repos, avec rotation des clés via AWS KMS. Smart Fields et les checkouts hébergés gardent les données de carte brutes hors de vos serveurs.

Puis-je enregistrer des cartes pour des débits ultérieurs ?

Oui. La tokenisation est disponible en Argentine, en Colombie, au Mexique et au Pérou. Vous conservez le jeton, jamais le PAN, et le débitez ensuite pour des rachats ou des abonnements.

Dans quelle devise les paiements par carte sont-ils débités ?

Les cartes sont débitées dans la monnaie locale de chaque marché (ARS, COP et MXN), en PEN ou en USD au Pérou, puis créditées sur votre compte dans votre devise de règlement.

Acceptez les paiements par carte avec un parcours de paiement pensé pour chaque marché.

Convertissez plus de paiements par carte, avec moins de risque

Des achats répétés plus rapides

Des paniers plus élevés grâce à l’échelonnement

Moins de fraude

Un périmètre PCI réduit

Parlez à notre équipe commerciale

Les réseaux internationaux que les acheteurs utilisent déjà

Argentine

Colombie

Mexique

Pérou

Programmes cartes par secteur

E-commerce & marketplaces

SaaS

Biens numériques & streaming

Voyage

Le parcours d’un paiement par carte

Saisie

Autorisation

Authentification si nécessaire

Confirmation

Ce qui est disponible dans chaque pays

Tout ce dont l’acceptation des cartes a besoin

3D Secure

Liste blanche de BIN

Gestion des rétrofacturations

Paiement échelonné

Pré-autorisation et capture

Remboursements

Gardez les données de carte hors de vos serveurs

Encaissez une carte tokenisée

Débitez une carte tokenisée

Questions fréquentes

Aussi sur la même API

Checkout

Paiements récurrents

Encaissements

Couverture

Annuaire des moyens de paiement

Parcours de paiement

Démarrage rapide développeurs

Acceptez les cartes à la manière locale