Aller au contenu

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, Diners Club, Naranja et Cabal 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.

  • Argentine · Colombie · Mexique · Pérou
  • Visa, Mastercard, Amex, Diners, Naranja, Cabal
  • PEN et USD au Pérou
Pays : Argentine, Colombie, Mexique et Pérou
4
Marques de cartes : Visa, Mastercard, Amex, Diners, Naranja et Cabal
6
En Colombie, au Mexique et au Pérou
3D Secure
En Colombie, au Mexique et au Pérou
Paiement échelonné

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
    ✓

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

  • Tokenisation et carte enregistrée

    Remplacez les données de carte par un jeton pour les clients récurrents, des paiements répétés plus rapides et les abonnements.

  • 3D Secure

    Authentification forte du client en Colombie, au Mexique et au Pérou. Lorsque l’émetteur exige un challenge, l’API renvoie l’URL correspondante.

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

  • Gestion des rétrofacturations

    Recevez les webhooks de rétrofacturation et envoyez vos justificatifs via l’API dans le délai de réponse.

Risque

3D Secure, liste blanche de BIN et gestion des rétrofacturations

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.

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

Fonctionnement

Le parcours d’un paiement par carte

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

  2. 02

    Autorisation

    Appelez POST /api/payin/ avec paymentMethod.type CreditCard et le code de la marque pour le pays.

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

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

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

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, Naranja et Cabal en Argentine et American Express et Diners Club 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 cartes à la manière locale

Parlez à notre équipe de l’acceptation des cartes en Argentine, en Colombie, au Mexique et au Pérou.

Comment pouvons-nous vous aider ?

Téléchargez votre exemplaire

Laissez vos coordonnées et recevez l’édition complète immédiatement.