Skip to main content
Akzeptieren Sie UPI und in Indien ausgestellte Karten, einschließlich Visa, Mastercard und RuPay, von Kunden in Indien. UPI macht mehr als 80 % der digitalen Zahlungstransaktionen in Indien gemessen am Volumen aus. Dodo Payments unterstützt Abonnements für beide Methoden über RBI-konforme Mandate.

Warum indische Zahlungsmethoden wichtig sind

UPI Dominance

UPI verarbeitet mehr als 20 Milliarden Transaktionen pro Monat, und viele indische Kunden besitzen keine internationale Karte.

Low-Value Payments

UPI akzeptiert Zahlungen ab ₹5 und eignet sich daher für Transaktionen mit hohem Volumen und geringem Wert.

Subscription Support

Im Gegensatz zu den meisten alternativen Zahlungsmethoden unterstützen UPI und in Indien ausgestellte Karten, einschließlich Visa, Mastercard und RuPay, wiederkehrende Zahlungen über RBI-Mandate.

Unterstützte Methoden

Die Tabelle enthält jede Methode, gibt an, ob sie Abonnements unterstützt, und nennt den Mindestbetrag: *Für Abonnements sind RBI-konforme Mandate mit speziellen Verarbeitungsregeln erforderlich. Die Verarbeitungsverzögerung von 48 Stunden gilt für wiederkehrende Abbuchungen von allen in Indien ausgestellten Karten und über UPI. Eine in INR abgerechnete Zahlung muss sowohl bei einmaligen Zahlungen als auch bei Abonnements mindestens ₹5 betragen.

Konfiguration

API-Methodentypen

Übergeben Sie diese Werte in allowed_payment_method_types:
Checkout bietet UPI ausschließlich als upi_intent an. Wenn allowed_payment_method_types upi_collect, aber nicht upi_intent enthält, wird UPI beim Checkout nicht angezeigt.

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:
  1. Das Rechnungsland ist Indien (IN).
  2. Die Abrechnungswährung ist INR.
  3. 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.
Wenn Sie ein Händler außerhalb Indiens sind und Adaptive Currency deaktiviert ist, können Ihre Kunden Abonnements nicht mit UPI bezahlen.

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: Der bei der Bank des Kunden registrierte Betrag ist 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 Feld mandate_min_amount_inr_paise in INR-Paise fest (₹1 = 100 Paise).
Diese Einstellung betrifft nur E-Mandate, die für in Indien ausgestellte Karten (Visa, Mastercard, RuPay) bei INR-Abonnements registriert sind. UPI-Abonnements verwenden ihren eigenen AutoPay-Ablauf und sind davon nicht betroffen.
Sie können den Systemstandard von ₹15.000 auf drei Ebenen überschreiben: Dodo Payments verwendet den ersten festgelegten Wert: zuerst die Überschreibung pro Anfrage, dann die Händlereinstellung und anschließend den Systemstandard. Um das Limit festzulegen, übergeben Sie mandate_min_amount_inr_paise im Request-Body, wenn Sie eine Checkout-Session erstellen. Der veraltete Endpunkt Create Subscription akzeptiert dasselbe Feld.
Das Feld akzeptiert folgende Werte:
Ein höheres Limit ermöglicht später größere einmalige Abbuchungen, etwa bei Plan-Upgrades oder nutzungsabhängigen Mehrkosten, ohne dass Kunden erneut autorisieren müssen. Ein niedrigeres Limit hält die Autorisierung des Kunden näher am tatsächlichen Abrechnungsbetrag, lässt jedoch weniger Spielraum für zukünftige variable Abbuchungen.

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:
1

Charge Initiated (Day 0)

Am geplanten Verlängerungsdatum initiiert Dodo Payments die Abbuchung bei der Bank.
2

Pre-Debit Notification

Die Bank des Kunden benachrichtigt ihn über die bevorstehende Abbuchung.
3

48-Hour Window

Während dieses Zeitraums kann der Kunde das Mandat in seiner Banking-App kündigen.
4

Debit Completed (~48-51 Hours)

Nach 48 Stunden sowie einer zusätzlichen Verarbeitungszeit von bis zu 3 Stunden belastet die Bank den Betrag.
5

Webhook Sent

Dodo Payments sendet den Webhook payment.succeeded nach der tatsächlichen Abbuchung, nicht bei der Initiierung der Abbuchung.
Gewähren Sie keine Vorteile bei der Initiierung der Abbuchung. Warten Sie auf den Webhook payment.succeeded, der ungefähr 48–51 Stunden nach dem geplanten Abbuchungsdatum eintrifft.

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

Entwickeln Sie Ihre Anwendung so, dass sie die Zeitspanne zwischen der Initiierung der Abbuchung und der tatsächlichen Zahlung verarbeitet. Berücksichtigen Sie:
  • Kulanzzeiträume für den Abonnementzugriff
  • Klare Kommunikation mit Kunden über die Verarbeitungsdauer
  • Webhook-gesteuerte Erfüllung statt datumsbasierter Erfüllung
Kunden können Mandate jederzeit in ihren Banking-Apps kündigen. Überwachen Sie Webhooks von subscription.on_hold und fordern Sie Kunden auf, das Abonnement erneut abzuschließen oder ihre Zahlungsmethode zu aktualisieren.
Prüfen Sie bei variablen Preisen, etwa bei nutzungsabhängiger Abrechnung, ob ein On-demand-Mandat mit dem Mandatslimit (standardmäßig ₹15.000) Ihre größte Abbuchung abdeckt. Falls Abbuchungen diesen Betrag überschreiten könnten, erhöhen Sie das Limit mit mandate_min_amount_inr_paise. Andernfalls müssen Kunden ein neues Mandat autorisieren.
Machen Sie UPI für indische Kunden zur primären Zahlungsoption. Viele bevorzugen UPI gegenüber Karten, weil es ihnen vertraut ist und weniger Reibung verursacht.

Fehlerbehebung

Prüfen Sie:
  1. Ist das Rechnungsland auf IN gesetzt?
  2. Ist die Abrechnungswährung auf INR gesetzt?
  3. Ist Adaptive Currency aktiviert, wenn Sie ein Händler außerhalb Indiens sind?
  4. Ist upi_intent in allowed_payment_method_types enthalten?
Lösung: Setzen Sie 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.
Ursache: Der Betrag der neuen Abbuchung überschreitet das bestehende Mandatslimit: das Mandatslimit (standardmäßig ₹15.000) oder den Abonnementbetrag, falls dieser höher ist.Lösung: Der Kunde muss seine Zahlungsmethode aktualisieren, um ein neues Mandat mit dem korrekten Limit einzurichten.
Ursache: Der Kunde hat das Mandat möglicherweise während des 48-Stunden-Zeitfensters gekündigt oder seine Bank hat die Abbuchung abgelehnt.Lösung: Der Kunde muss das Mandat erneut autorisieren oder seine Zahlungsmethode aktualisieren.
Ursache: Verzögerungen bei der Bank-API können die Verarbeitung um 2–3 Stunden verlängern.Lösung: Dies ist erwartungsgemäß. Entwickeln Sie Ihr System so, dass es insgesamt Verzögerungen von bis zu etwa 51 Stunden verarbeitet.
Ursache: Eine Besonderheit der RBI-Vorschriften: Durch das Kündigen eines Mandats während des Verarbeitungszeitfensters wird das Abonnement nicht sofort gekündigt.Lösung: Die nächste Abbuchung schlägt fehl und das Abonnement wechselt zu on_hold. Überwachen Sie Webhooks für payment.failed.

Verwandte Seiten

Payment Methods Overview

Alle unterstützten Zahlungsmethoden anzeigen.

Subscriptions

Vollständige Dokumentation zu Abonnements einschließlich RBI-Mandaten.

Webhooks

Webhook-Verarbeitung für Zahlungsereignisse.

Testing Process

Alle Testdaten einschließlich UPI-IDs und indischer Karten.
Zuletzt geändert am 26. September 2026