Skip to main content
L’Inde dispose d’une infrastructure de paiement unique, dominée par UPI (plus de 60 % des transactions numériques) et les cartes émises en Inde (Visa, Mastercard, Rupay, etc.). Dodo Payments prend en charge toutes ces méthodes dans le respect total des exigences de la RBI pour les mandats d’abonnement.

Pourquoi les méthodes de paiement en Inde sont importantes

UPI Dominance

UPI traite plus de 10 milliards de transactions par mois. De nombreux clients indiens ne disposent pas de cartes internationales.

Low Transaction Costs

UPI entraîne des frais de transaction quasi nuls. Cette méthode est idéale pour les transactions à volume élevé et à faible valeur.

Subscription Support

Contrairement à la plupart des méthodes de paiement alternatives, UPI et toutes les cartes émises en Inde (Visa, Mastercard, Rupay, etc.) prennent en charge les paiements récurrents via des mandats de la RBI.

Méthodes prises en charge

*Les abonnements nécessitent des mandats conformes aux exigences de la RBI et soumis à des règles de traitement particulières. Le délai de traitement de 48 heures s’applique à toutes les cartes émises en Inde et à UPI.

Configuration

Types de méthodes API

Exemple : checkout destiné à l’Inde

Conditions requises pour UPI

Pour que UPI apparaisse lors du checkout :
  1. Le pays de facturation doit être l’Inde (IN)
  2. La devise doit être INR
  3. Pour les marchands non indiens : Adaptive Currency doit être activé
Si vous êtes un marchand non indien et que Adaptive Currency n’est pas activé, UPI ne sera pas disponible pour vos clients.

Abonnements avec des mandats de la RBI

Les abonnements utilisant des méthodes de paiement indiennes sont régis par les réglementations de la RBI (Reserve Bank of India), qui imposent des exigences particulières.

Fonctionnement des mandats de la RBI

Types de mandats

Le montant enregistré auprès de la banque du client est max(mandate_floor, billing_amount). Le seuil constitue donc effectivement le plafond d’autorisation visible par le client lorsque la facturation est inférieure à ce seuil. Important pour les changements de forfait : si une mise à niveau entraîne des frais supérieurs à la limite du mandat existant, le débit échouera et le client devra s’authentifier à nouveau.

Seuil de mandat configurable

Le seuil de mandat pour les e-mandats en INR peut être configuré via le champ mandate_min_amount_inr_paise (en paise INR — 1 INR = 100 paise). Vous pouvez remplacer la valeur par défaut du système, ₹15 000, à trois niveaux : Ordre de priorité : remplacement par requête → paramètre du marchand → valeur par défaut du système.
La définition d’un seuil plus élevé vous permet de prendre en charge ultérieurement des débits ponctuels plus importants (par exemple, les mises à niveau de forfait ou les dépassements facturés à l’usage) sans obliger les clients à s’authentifier à nouveau. Un seuil plus faible rapproche l’autorisation du client du montant réellement facturé, mais limite la marge disponible pour de futurs débits variables.
Ce paramètre affecte uniquement les e-mandats enregistrés pour les cartes émises en Inde (Visa, Mastercard, RuPay) associés à des abonnements en INR. Les abonnements UPI suivent leur propre flux AutoPay et ne sont pas concernés.

Le délai de traitement de 48 heures

Il s’agit de la différence la plus importante par rapport aux paiements internationaux par carte :
1

Charge Initiated (Day 0)

À la date de renouvellement prévue, Dodo initie le débit auprès de la banque.
2

Pre-Debit Notification

Le client reçoit une notification de sa banque concernant le débit à venir.
3

48-Hour Window

Le client peut annuler le mandat pendant cette période via son application bancaire.
4

Debit Completed (~48-51 hours)

Après 48 heures (plus 3 heures supplémentaires au maximum pour le traitement bancaire), les fonds sont débités.
5

Webhook Sent

Le webhook payment.succeeded est envoyé après le débit effectif, et non lors de son initialisation.
N’accordez pas les avantages au moment de l’initialisation du débit. Attendez le webhook payment.succeeded, qui arrive environ 48 à 51 heures après la date de débit prévue.

Gestion de la fenêtre de 48 heures

Événements webhook pour les abonnements indiens

Tests

Identifiants de test UPI

Numéros de test des cartes indiennes

Bonnes pratiques

Concevez votre application pour gérer l’écart entre l’initialisation du débit et le paiement effectif. Envisagez les éléments suivants :
  • Des périodes de grâce pour l’accès à l’abonnement
  • Une communication claire aux clients concernant le délai de traitement
  • Une gestion de l’accès pilotée par les webhooks, et non par les dates
Les clients peuvent annuler leurs mandats à tout moment via l’application de leur banque. Surveillez les webhooks subscription.on_hold et invitez les clients à se réabonner ou à mettre à jour leurs méthodes de paiement.
Pour une tarification variable (par exemple, basée sur l’usage), vérifiez si un mandat à la demande de 15 000 Rs est suffisant. Si les débits peuvent dépasser ce montant, les clients devront s’authentifier à nouveau.
Pour les clients indiens, UPI devrait être l’option de paiement principale. De nombreux utilisateurs la préfèrent aux cartes en raison de sa familiarité et de sa simplicité.

Dépannage

Vérifiez :
  1. Le pays de facturation est-il défini sur IN ?
  2. La devise est-elle définie sur INR ?
  3. Pour un marchand non indien : Adaptive Currency est-il activé ?
  4. upi_collect est-il inclus dans allowed_payment_method_types ?
Solution : vérifiez que l’adresse de facturation contient country: "IN" et billing_currency: "INR".
Cause : le montant du nouveau débit dépasse la limite du mandat existant (seuil de 15 000 Rs).Solution : le client doit mettre à jour sa méthode de paiement afin d’établir un nouveau mandat avec la limite appropriée.
Cause : le client a peut-être annulé le mandat pendant la fenêtre de 48 heures, ou sa banque a refusé le débit.Solution : le client doit à nouveau autoriser le mandat ou mettre à jour sa méthode de paiement.
Cause : les délais de l’API bancaire peuvent prolonger le traitement de 2 à 3 heures supplémentaires.Solution : ce comportement est attendu. Concevez votre système pour gérer des délais variables pouvant atteindre environ 51 heures au total.
Cause : cas particulier des réglementations de la RBI : l’annulation d’un mandat pendant la fenêtre de traitement n’annule pas immédiatement l’abonnement.Solution : le prochain débit échouera et l’abonnement passera à on_hold. Surveillez les webhooks pour détecter payment.failed.

Pages associées

Payment Methods Overview

Consultez toutes les méthodes de paiement prises en charge.

Subscriptions

Consultez la documentation complète sur les abonnements, y compris les mandats de la RBI.

Webhooks

Découvrez la gestion des webhooks pour les événements de paiement.

Testing Process

Consultez toutes les données de test, y compris les identifiants UPI et les cartes indiennes.
Dernière modification le 31 juillet 2026