Cartes (Visa & Mastercard)

Aperçu

Acceptez les paiements par carte de crédit et de débit via l'API Cost+ en utilisant la méthode de paiement credit-card.

{
  "transactions": [
    {
      "payment_method": "credit-card"
    }
  ]
}

Marques de cartes prises en charge

Marque	Type
Amex	Crédit
Mastercard	Crédit / Débit
Maestro	Débit
Visa	Crédit / Débit
V Pay	Débit

Options de configuration

Descripteur dynamique

Utilisez le champ dynamic_descriptor pour définir un texte personnalisé qui apparaît sur le relevé bancaire ou de carte de votre client.

{
  "transactions": [
    {
      "payment_method": "credit-card",
      "payment_method_details": {
        "dynamic_descriptor": "My Store Order 123"
      }
    }
  ]
}

Utiliser le nom du client comme nom du titulaire de la carte

Définissez use_customer_name_as_cardholder_name à true pour utiliser automatiquement le nom du client de la commande comme nom du titulaire de la carte.

{
  "transactions": [
    {
      "payment_method": "credit-card",
      "payment_method_details": {
        "use_customer_name_as_cardholder_name": true
      }
    }
  ]
}

Formulaire de saisie de carte personnalisé

Si vous souhaitez créer votre propre formulaire de saisie de carte au lieu d'utiliser la page de paiement hébergée, suivez ces quatre étapes.

Étape 1 : Créer une commande avec un token de configuration

Créez une commande et incluez setup_token: true dans les payment_method_details de la transaction. Cela indique à Cost+ de générer un token de configuration que vous pouvez utiliser pour tokeniser les données de carte de manière sécurisée.

curl -X POST https://api.costplus.online/v1/orders \
  -u your-api-key: \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "EUR",
    "amount": 5000,
    "merchant_order_id": "order-001",
    "transactions": [
      {
        "payment_method": "credit-card",
        "payment_method_details": {
          "setup_token": true
        }
      }
    ],
    "return_url": "https://example.com/return",
    "webhook_url": "https://example.com/webhook"
  }'

La réponse inclura une valeur setup_token dans les payment_method_details de la transaction :

{
  "id": "order-uuid",
  "transactions": [
    {
      "id": "txn-uuid",
      "payment_method": "credit-card",
      "payment_method_details": {
        "setup_token": "st_abc123..."
      }
    }
  ]
}

Étape 2 : Tokeniser les données de la carte

Envoyez le PAN de la carte, la date d'expiration et le token de configuration au point d'accès de tokenisation. Cela enregistre la carte de manière sécurisée et renvoie un vault_token.

curl -X POST https://api.costplus.online/v1/tokens/ \
  -H "Content-Type: application/json" \
  -d '{
    "pan": "4111111111111111",
    "expiry_date": "1228",
    "setup_token": "st_abc123..."
  }'

Réponse :

{
  "vault_token": "vt_xyz789..."
}

Étape 3 : Authentifier la transaction

Soumettez le vault_token et le cvc au point d'accès d'authentification. Si 3D Secure est requis, vous recevrez une redirect_url pour rediriger le client vers la page d'authentification de sa banque.

curl -X POST https://api.costplus.online/v1/orders/{order_id}/transactions/{transaction_id}/authenticate/ \
  -u your-api-key: \
  -H "Content-Type: application/json" \
  -d '{
    "vault_token": "vt_xyz789...",
    "cvc": "123"
  }'

Réponse :

{
  "redirect_url": "https://3ds.bank.example.com/auth?id=..."
}

Redirigez le client vers redirect_url pour compléter l'authentification 3D Secure. Après que le client a terminé (ou annulé) l'authentification, il sera redirigé vers votre return_url.

Étape 4 : Interroger le statut de la commande

Après le retour du client depuis 3D Secure, interrogez la commande pour vérifier le statut final.

curl -X GET https://api.costplus.online/v1/orders/{order_id} \
  -u your-api-key:

Le status de la commande passera à l'un des suivants :

Statut	Signification
`completed`	Le paiement a réussi
`cancelled`	Le client a annulé ou l'authentification a échoué
`error`	Une erreur s'est produite pendant le traitement
`expired`	La commande a expiré avant d'être finalisée

Pour les flux d'autorisation et de capture manuels avec les paiements par carte, consultez le guide Autorisation / Capture / Annulation.

On this page