Warum indische Zahlungsmethoden wichtig sind
UPI Dominance
Low-Value Payments
Subscription Support
Unterstützte Methoden
Die Tabelle enthält jede Methode, gibt an, ob sie Abonnements unterstützt, und nennt den Mindestbetrag:Konfiguration
API-Methodentypen
Übergeben Sie diese Werte inallowed_payment_method_types:
Beispiel: Auf Indien ausgerichteter Checkout
Diese Session bietet einem Kunden in Indien UPI und Karten an und wird in INR abgerechnet:Voraussetzungen für UPI
UPI wird beim Checkout nur angezeigt, wenn alle folgenden Bedingungen erfüllt sind:- Das Rechnungsland ist Indien (
IN). - Die Abrechnungswährung ist INR.
- Für Abonnements von Händlern außerhalb Indiens ist Adaptive Currency aktiviert. Einmalige Checkouts benötigen diese Einstellung nicht, wenn das Produkt in INR bepreist ist.
Abonnements mit RBI-Mandaten
Mit UPI oder in Indien ausgestellten Karten bezahlte Abonnements basieren auf Mandaten der RBI (Reserve Bank of India), für die zusätzliche Regeln gelten, die bei anderen Zahlungsmethoden nicht vorhanden sind.Funktionsweise von RBI-Mandaten
Der Kunde autorisiert ein Mandat, wenn er ein Abonnement abschließt. Jede Verlängerungsabbuchung wartet anschließend nach einer Vorab-Benachrichtigung 48 Stunden, bevor die Bank den Betrag abbucht:Mandattypen
Der Mandattyp hängt davon ab, wie der Abonnementbetrag im Verhältnis zum Mandatslimit steht:max(mandate_floor, billing_amount). Wenn der Abrechnungsbetrag unter dem Limit liegt, wird das Limit zur kundenorientierten Autorisierungsobergrenze.
Planänderungen: Wenn ein Upgrade eine Abbuchung erzeugt, die über dem bestehenden Mandatslimit liegt, schlägt die Abbuchung fehl und der Kunde muss erneut autorisieren.
Konfigurierbares Mandatslimit
Legen Sie das Mandatslimit für INR-E-Mandate mit dem Feldmandate_min_amount_inr_paise in INR-Paise fest (₹1 = 100 Paise).
Sie können den Systemstandard von ₹15.000 auf drei Ebenen überschreiben:
mandate_min_amount_inr_paise im Request-Body, wenn Sie eine Checkout-Session erstellen. Der veraltete Endpunkt Create Subscription akzeptiert dasselbe Feld.
Die Verarbeitungsverzögerung von 48 Stunden
Eine Verlängerungsabbuchung von einer indischen Karte oder über UPI wird ungefähr 48 Stunden nach dem Verlängerungsdatum abgeschlossen. Dies ist der wichtigste Unterschied zu internationalen Kartenzahlungen:Charge Initiated (Day 0)
Pre-Debit Notification
48-Hour Window
Debit Completed (~48-51 Hours)
Webhook Sent
payment.succeeded nach der tatsächlichen Abbuchung, nicht bei der Initiierung der Abbuchung.Umgang mit dem 48-Stunden-Zeitfenster
Gewähren Sie den Zugriff über den Payment-Webhook und nicht anhand des Verlängerungsdatums:Webhook-Ereignisse für indische Abonnements
Verarbeiten Sie diese Ereignisse für Abonnements, die mit UPI oder in Indien ausgestellten Karten bezahlt werden:Testen
UPI-Test-IDs
Geben Sie im Testmodus diese UPI-IDs ein, um die jeweiligen Ergebnisse zu simulieren:Testnummern für indische Karten
Verwenden Sie diese in Indien ausgestellten Testkarten:Best Practices
Plan for the 48-hour delay
Plan for the 48-hour delay
- Kulanzzeiträume für den Abonnementzugriff
- Klare Kommunikation mit Kunden über die Verarbeitungsdauer
- Webhook-gesteuerte Erfüllung statt datumsbasierter Erfüllung
Handle mandate cancellations
Handle mandate cancellations
subscription.on_hold und fordern Sie Kunden auf, das Abonnement erneut abzuschließen oder ihre Zahlungsmethode zu aktualisieren.Set appropriate mandate amounts
Set appropriate mandate amounts
mandate_min_amount_inr_paise. Andernfalls müssen Kunden ein neues Mandat autorisieren.Offer UPI prominently
Offer UPI prominently
Fehlerbehebung
UPI not appearing at checkout
UPI not appearing at checkout
- Ist das Rechnungsland auf
INgesetzt? - Ist die Abrechnungswährung auf
INRgesetzt? - Ist Adaptive Currency aktiviert, wenn Sie ein Händler außerhalb Indiens sind?
- Ist
upi_intentinallowed_payment_method_typesenthalten?
country: "IN" in der Rechnungsadresse und billing_currency: "INR". Wenn Adaptive Currency deaktiviert ist, ignoriert die API billing_currency. Bepreisen Sie das Produkt stattdessen in 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. Überwachen Sie Webhooks für payment.failed.