Skip to main content
Acceptez UPI et les cartes émises en Inde, notamment Visa, Mastercard et RuPay, de la part de clients en Inde. UPI représente plus de 80 % des transactions de paiement numériques en Inde en volume. Dodo Payments prend en charge les abonnements avec ces deux méthodes grâce à des mandats conformes aux exigences de la RBI.

Pourquoi les méthodes de paiement en Inde sont importantes

UPI Dominance

UPI traite plus de 20 milliards de transactions par mois, et de nombreux clients indiens ne disposent pas de carte internationale.

Low-Value Payments

UPI accepte les paiements à partir de ₹5, ce qui convient aux transactions à volume élevé et à faible montant.

Subscription Support

Contrairement à la plupart des moyens de paiement alternatifs, UPI et les cartes émises en Inde, notamment Visa, Mastercard et RuPay, prennent en charge les paiements récurrents au moyen de mandats RBI.

Méthodes prises en charge

Le tableau répertorie chaque méthode, indique si elle prend en charge les abonnements et précise son montant minimum : *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 aux prélèvements récurrents sur toutes les cartes émises en Inde et à UPI. Un paiement facturé en INR doit être d’au moins ₹5, qu’il s’agisse d’un paiement ponctuel ou d’un abonnement.

Configuration

Types de méthodes API

Transmettez ces valeurs dans allowed_payment_method_types :
Le Checkout propose UPI uniquement en tant que upi_intent. Si allowed_payment_method_types répertorie upi_collect, mais pas upi_intent, UPI n’apparaît pas lors du Checkout.

Exemple : Checkout ciblé sur l’Inde

Cette session propose UPI et les cartes à un client en Inde, avec une facturation en INR :

Conditions requises pour UPI

UPI apparaît lors du Checkout uniquement lorsque toutes les conditions suivantes sont remplies :
  1. Le pays de facturation est l’Inde (IN).
  2. La devise de facturation est l’INR.
  3. Pour les abonnements de marchands situés hors d’Inde, Adaptive Currency est activé. Les Checkouts ponctuels n’en ont pas besoin si le produit est tarifé en INR.
Si vous êtes un marchand situé hors d’Inde et que Adaptive Currency est désactivé, vos clients ne peuvent pas payer leurs abonnements avec UPI.

Abonnements avec des mandats RBI

Les abonnements payés avec UPI ou des cartes émises en Inde reposent sur des mandats RBI (Reserve Bank of India), qui ajoutent des règles ne s’appliquant pas aux autres méthodes de paiement.

Fonctionnement des mandats RBI

Le client autorise un mandat lors de son abonnement. Chaque prélèvement de renouvellement attend ensuite 48 heures après une notification de pré-débit avant que la banque ne prélève les fonds :

Types de mandats

Le type de mandat dépend de la comparaison entre le montant de l’abonnement et le plafond du mandat : Le montant enregistré auprès de la banque du client est max(mandate_floor, billing_amount). Lorsque le montant de facturation est inférieur au plafond, celui-ci devient le plafond d’autorisation visible par le client. Modifications du plan : si une mise à niveau génère un prélèvement supérieur à la limite du mandat existant, le prélèvement échoue et le client doit à nouveau l’autoriser.

Plafond de mandat configurable

Définissez le plafond du mandat pour les e-mandats en INR avec le champ mandate_min_amount_inr_paise, en paise INR (₹1 = 100 paise).
Ce paramètre concerne uniquement les e-mandats enregistrés pour des cartes émises en Inde (Visa, Mastercard, RuPay) pour des abonnements en INR. Les abonnements UPI suivent leur propre flux AutoPay et ne sont pas concernés.
Vous pouvez remplacer la valeur par défaut du système, fixée à ₹15,000, à trois niveaux : Dodo Payments utilise la première valeur définie : le remplacement par requête, puis le paramètre du marchand, puis la valeur par défaut du système. Pour définir le plafond, transmettez mandate_min_amount_inr_paise dans le corps de la requête lorsque vous créez une session Checkout. Le point de terminaison obsolète Create Subscription accepte le même champ.
Le champ accepte les valeurs suivantes :
Un plafond plus élevé vous permet d’effectuer ultérieurement des prélèvements ponctuels plus importants, comme lors de mises à niveau de plan ou de dépassements liés à l’utilisation, sans demander aux clients de procéder à une nouvelle autorisation. Un plafond plus bas rapproche l’autorisation du client du montant de facturation réel, mais laisse moins de marge pour les futurs prélèvements variables.

Le délai de traitement de 48 heures

Un prélèvement de renouvellement sur une carte indienne ou via UPI est finalisé environ 48 heures après la date de renouvellement. Il s’agit de la principale différence par rapport aux paiements par carte internationale :
1

Charge Initiated (Day 0)

À la date de renouvellement prévue, Dodo Payments lance le prélèvement auprès de la banque.
2

Pre-Debit Notification

La banque du client l’informe du prélèvement à venir.
3

48-Hour Window

Pendant cette période, le client peut annuler le mandat dans son application bancaire.
4

Debit Completed (~48-51 Hours)

Après 48 heures, auxquelles peuvent s’ajouter jusqu’à 3 heures de traitement bancaire, la banque prélève les fonds.
5

Webhook Sent

Dodo Payments envoie le webhook payment.succeeded après le prélèvement effectif, et non au lancement du prélèvement.
N’accordez pas les avantages au lancement du prélèvement. Attendez le webhook payment.succeeded, qui arrive environ 48 à 51 heures après la date de prélèvement prévue.

Gestion de la fenêtre de 48 heures

Accordez l’accès à partir du webhook de paiement, et non de la date de renouvellement :

Événements webhook pour les abonnements indiens

Gérez ces événements pour les abonnements payés avec UPI ou des cartes émises en Inde :

Tests

Identifiants de test UPI

En mode test, saisissez ces identifiants UPI pour simuler chaque résultat :

Numéros de carte indienne de test

Utilisez ces cartes de test émises en Inde :

Bonnes pratiques

Concevez votre application pour gérer l’intervalle entre le lancement du prélèvement et le paiement effectif. Prenez en compte les éléments suivants :
  • Des périodes de grâce pour l’accès aux abonnements
  • Une communication claire aux clients concernant le délai de traitement
  • Une exécution pilotée par les webhooks, et non par les dates
Les clients peuvent annuler leurs mandats à tout moment dans leurs applications bancaires. Surveillez les webhooks subscription.on_hold et invitez les clients à s’abonner à nouveau ou à mettre à jour leur méthode de paiement.
Pour une tarification variable, comme la facturation à l’utilisation, vérifiez si un mandat à la demande égal au plafond du mandat (₹15,000 par défaut) couvre votre prélèvement le plus élevé. Si les prélèvements peuvent le dépasser, augmentez le plafond avec mandate_min_amount_inr_paise. Dans le cas contraire, les clients devront autoriser un nouveau mandat.
Pour les clients indiens, faites d’UPI l’option de paiement principale. Beaucoup la préfèrent aux cartes, car elle leur est familière et offre un parcours plus fluide.

Résolution des problèmes

Vérifiez :
  1. Le pays de facturation est-il défini sur IN ?
  2. La devise de facturation est-elle définie sur INR ?
  3. Si vous êtes un marchand situé hors d’Inde, Adaptive Currency est-il activé ?
  4. upi_intent est-il inclus dans allowed_payment_method_types ?
Solution : définissez country: "IN" dans l’adresse de facturation et billing_currency: "INR". Si Adaptive Currency est désactivé, l’API ignore billing_currency ; fixez donc le prix du produit en INR.
Cause : le montant du nouveau prélèvement dépasse la limite du mandat existant : le plafond du mandat (₹15,000 par défaut), ou le montant de l’abonnement s’il est supérieur.Solution : le client doit mettre à jour sa méthode de paiement afin de configurer 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 prélèvement.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.Solution : ce comportement est attendu. Concevez votre système pour gérer des délais pouvant atteindre environ 51 heures au total.
Cause : un cas particulier de la réglementation RBI : l’annulation d’un mandat pendant la fenêtre de traitement n’annule pas immédiatement l’abonnement.Solution : le prochain prélèvement échoue et l’abonnement passe à on_hold. Surveillez les webhooks pour payment.failed.

Pages associées

Payment Methods Overview

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

Subscriptions

Documentation complète des abonnements, y compris les mandats RBI.

Webhooks

Gestion des webhooks pour les événements de paiement.

Testing Process

Toutes les données de test, y compris les identifiants UPI et les cartes indiennes.
Dernière modification le 26 septembre 2026