Pourquoi les méthodes de paiement en Inde sont importantes
UPI Dominance
Low-Value Payments
Subscription Support
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 :Configuration
Types de méthodes API
Transmettez ces valeurs dansallowed_payment_method_types :
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 :- Le pays de facturation est l’Inde (
IN). - La devise de facturation est l’INR.
- 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.
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 :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 champmandate_min_amount_inr_paise, en paise INR (₹1 = 100 paise).
Vous pouvez remplacer la valeur par défaut du système, fixée à ₹15,000, à trois niveaux :
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 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 :Charge Initiated (Day 0)
Pre-Debit Notification
48-Hour Window
Debit Completed (~48-51 Hours)
Webhook Sent
payment.succeeded après le prélèvement effectif, et non au lancement du prélèvement.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
Plan for the 48-hour delay
Plan for the 48-hour delay
- 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
Handle mandate cancellations
Handle mandate cancellations
subscription.on_hold et invitez les clients à s’abonner à nouveau ou à mettre à jour leur méthode de paiement.Set appropriate mandate amounts
Set appropriate mandate amounts
mandate_min_amount_inr_paise. Dans le cas contraire, les clients devront autoriser un nouveau mandat.Offer UPI prominently
Offer UPI prominently
Résolution des problèmes
UPI not appearing at checkout
UPI not appearing at checkout
- Le pays de facturation est-il défini sur
IN? - La devise de facturation est-elle définie sur
INR? - Si vous êtes un marchand situé hors d’Inde, Adaptive Currency est-il activé ?
upi_intentest-il inclus dansallowed_payment_method_types?
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.Subscription charge failed after upgrade
Subscription charge failed after upgrade
Subscription on hold but customer claims they didn't cancel
Subscription on hold but customer claims they didn't cancel
Payment deduction delayed beyond 48 hours
Payment deduction delayed beyond 48 hours
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
on_hold. Surveillez les webhooks pour payment.failed.