Paiements récurrents (MIT)

Mettre en place des paiements récurrents initiés par le marchand et des abonnements

Les paiements récurrents vous permettent de débiter les clients selon un calendrier sans leur participation active. Il s'agit d'un flux de Transaction Initiée par le Marchand (MIT).

Fonctionnement

Le flux récurrent comporte deux phases :

Premier paiement — Le client s'authentifie et paie, accordant la permission pour les débits futurs
Paiements suivants — Vous débitez la carte enregistrée du client sans son intervention

Phase 1 : Premier paiement

Créez une commande avec recurring_type: "first" et un schedule_type :

POST /v1/orders/

{
  "merchant_order_id": "first-recurring",
  "currency": "EUR",
  "amount": 1295,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "recurring_type": "first",
      "schedule_type": "scheduled"
    }
  ]
}

Types de planification

Type	Description
`scheduled`	Calendrier fixe (ex. abonnement mensuel)
`unscheduled`	Fréquence variable (ex. recharge quand le solde est bas)

Après un paiement réussi, conservez le vault_token et/ou le first_transaction_id de la réponse.

Phase 2 : Paiement récurrent suivant

Débitez le client en utilisant le token enregistré :

POST /v1/orders/

{
  "merchant_order_id": "recurring-order",
  "currency": "EUR",
  "amount": 995,
  "transactions": [
    {
      "payment_method": "credit-card",
      "recurring_type": "recurring",
      "vault_token": "{vault_token}"
    }
  ]
}

Les paiements récurrents ne renvoient pas de payment_url dans la réponse puisqu'aucune interaction client n'est nécessaire. Le paiement est traité immédiatement.

Vous pouvez utiliser soit vault_token soit first_transaction_id pour référencer la carte enregistrée.

Validité du token

Les tokens récurrents ont une validité maximale d'un an. Après expiration, vous devez initier un nouveau premier paiement pour obtenir un token frais.

Assurez-vous que votre système gère l'expiration des tokens de manière élégante. Mettez en place un processus pour ré-authentifier les clients avant l'expiration de leurs tokens.

Récurrent vs Un clic

Caractéristique	Récurrent (MIT)	Un clic (CIT)
Initié par	Le marchand	Le client
Client présent	Non	Oui
Cas d'utilisation	Abonnements, facturation planifiée	Paiement rapide pour les clients récurrents
`schedule_type` requis	Oui	Non
`payment_url` retourné	Non	Oui

Points d'accès associés

Créer une commande — utilisez recurring_type et schedule_type dans la transaction pour configurer ou effectuer des paiements récurrents