# Abonnement mit nigerianischen Karten einrichten Erfahren Sie, wie Sie ein Abonnement mit nigerianischen Karten erstellen und abrechnen können. Richten Sie ein *Abonnement* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) mit [Naira-Karten](https://docs.stripe.com/payments/ng-card/accept-a-payment.md) als Zahlungsmethode ein. # SetupIntents API > This is a SetupIntents API for when api-integration is setupintents. View the full page at https://docs.stripe.com/billing/subscriptions/ng-card?api-integration=setupintents. Erstellen und bestätigen Sie ein Abonnement mithilfe von zwei API-Aufrufen. Der [erste API-Aufruf](https://docs.stripe.com/billing/subscriptions/ng-card.md#create-setup-intent) sendet Kunden- und Produktinformationen an die [Subscriptions API](https://docs.stripe.com/api/subscriptions.md), um ein Abonnement und einen PaymentIntent in einem Aufruf zu erstellen. Die Antwort enthält eine PaymentIntent-ID, die Sie in einem Aufruf der [Payment Intents API](https://docs.stripe.com/api/payment_intents.md) verwenden müssen, um eine Zahlung zu bestätigen. ## Produkt und Preis erstellen [Dashboard] [Produkte](https://docs.stripe.com/api/products.md) stehen für den von Ihnen angebotenen Artikel oder Dienst. [Preise](https://docs.stripe.com/api/prices.md) geben an, wie viel und wie häufig Sie für ein Produkt berechnen. Dies schließt ein, wie viel ein Produkt kostet, welche Währung Sie akzeptieren und ob es sich um eine einmalige oder eine wiederkehrende Zahlung handelt. Wenn Sie nur ein paar wenige Produkte und Preise haben, können Sie diese im Dashboard erstellen und verwalten. In diesem Leitfaden wird ein Stock-Foto-Service als Beispiel verwendet, für den Kund/innen ein monatliches Abonnement mit dem Betrag von 100,000 NGN berechnet werden. Um dies zu modellieren: 1. Gehen Sie zur Seite [Produkte](https://dashboard.stripe.com/products?active=true) und klicken Sie auf **Produkt erstellen**. 1. Geben Sie einen **Namen** für das Produkt an. Sie können optional eine **Beschreibung** hinzufügen und ein Bild des Produkts hochladen. 1. Wählen Sie einen **Produktsteuercode** aus. Erfahren Sie mehr über [Produktsteuercodes](https://docs.stripe.com/tax/tax-codes.md). 1. Wählen Sie **Wiederkehrend** aus. Geben Sie im Anschluss daran **100,000** für den Preis ein und wählen Sie **NGN** als Währung aus. 1. Wählen Sie, ob die **Steuer im Preis berücksichtigt** werden soll. Sie können entweder den Standardwert aus Ihren [Steuereinstellungen](https://dashboard.stripe.com/test/settings/tax) verwenden oder den Wert manuell festlegen. Wählen Sie in diesem Beispiel **Auto** aus. 1. Wählen Sie **Monatlich** als **Abrechnungszeitraum** aus. 1. Klicken Sie auf **Weitere Preisoptionen**. Wählen Sie dann **Pauschalpreis** als Preismodell für dieses Beispiel aus. Erfahren Sie mehr über [Pauschalpreise](https://docs.stripe.com/products-prices/pricing-models.md#flat-rate) und andere [Preismodelle](https://docs.stripe.com/products-prices/pricing-models.md). 1. Fügen Sie eine interne **Preisbeschreibung** und einen [Lookup-Schlüssel](https://docs.stripe.com/products-prices/manage-prices.md#lookup-keys) hinzu, um bestimmte Preise in Zukunft zu organisieren, abzufragen und zu aktualisieren. 1. Klicken Sie auf **Weiter**. Klicken Sie dann auf **Produkt hinzufügen**. Zeichnen Sie nach Erstellen des Produkts und des Preises die Preis-ID auf, sodass Sie diese in nachfolgenden Schritten verwenden können. Die ID wird auf der Preisseite angezeigt und sieht in etwa so aus: `price_G0FvDp6vZvdwRZ`. > Sie müssen Ihre Preise in NGN umwandeln, um die Zahlungsmethode zu verwenden. ## SetupIntent erstellen [Serverseitig] Erstellen Sie einen [SetupIntent](https://docs.stripe.com/api/setup_intents.md), um die kundenseitigen Zahlungsmethoden für spätere Zahlungen zu speichern. Der `SetupIntent` dokumentiert die Schritte dieses Einrichtungsvorgangs. ```curl curl https://api.stripe.com/v1/setup_intents \ -u "<>:" \ -d confirm=true \ --data-urlencode "return_url=https://www.stripe.com" \ -d usage=off_session \ -d customer=cus_ODQluYFNl44ODI \ -d "payment_method_data[type]=ng_card" \ -d "payment_method_types[]=ng_card" \ -d "mandate_data[customer_acceptance][type]=online" \ -d "mandate_data[customer_acceptance][online][ip_address]=127.0.0.0" \ -d "mandate_data[customer_acceptance][online][user_agent]=device" ``` Das SetupIntent-Objekt enthält ein eindeutiges `client_secret`. Übergeben Sie dieses auf der Client-Seite an Stripe.js, um Ihre Kundinnen/Kunden auf die Checkout-Seite unseres lokalen Verarbeiters weiterzuleiten und das Mandat zu autorisieren. ## Abonnement erstellen [Serverseitig] Erstellen Sie ein Abonnement mit einem Preis und einer Kundin/einem Kunden. Legen Sie den Wert des Parameters `default_payment_method` auf die PaymentMethod-ID aus der SetupIntent-Antwort fest. ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "items[0][price]={{PRICE_ID}}" \ -d default_payment_method={{PAYMENT_METHOD_ID}} \ -d off_session=true ``` Wenn Sie Abonnements erstellen, werden Kundinnen und Kunden ausstehende Zahlungen automatisch basierend auf deren voreingestellter Standardzahlungsmethode berechnet. War eine Zahlung erfolgreich, so ändert sich der Status im Stripe-Dashboard in `Active`. Der Preis, den Sie zuvor festgelegt haben, bestimmt den Betrag für zukünftige Abrechnungen. Erfahren Sie, wie Sie ein [Abonnement mit kostenlosem Testzeitraum erstellen](https://docs.stripe.com/billing/subscriptions/trials.md). ## Zahlungen bestätigen [Serverseitig] Bestätigen Sie eine Zahlung mit [PaymentIntents](https://docs.stripe.com/api/payment_intents.md) unter Verwendung der PaymentIntent-ID aus der Abonnement-Antwort. Fügen Sie die PaymentIntent-ID zum URL-Pfad hinzu und legen Sie den Wert des Parameters `payment_method_types` auf `ng_card` fest: ```curl curl https://api.stripe.com/v1/payment_intents/:id/confirm \ -u "<>:" \ --data-urlencode "return_url=https://www.stripe.com" \ -d "payment_method_data[]=type" \ -d "payment_method_data[]=ng_card" ``` Die PaymentIntent-Antwort enthält den Status `requires_action`. Das bedeutet, dass Ihre Kundinnen und Kunden die Zahlung mit der von ihnen ausgewählten Zahlungsmethode abschließen müssen, um den PaymentIntent abzuschließen. Nach erfolgreicher Zahlung wird das Abonnement aktiv und speichert die Zahlungsmethode als Standard-Zahlungsmethode. # Subscriptions API > This is a Subscriptions API for when api-integration is subscription. View the full page at https://docs.stripe.com/billing/subscriptions/ng-card?api-integration=subscription. Erstellen und bestätigen Sie ein Abonnement mithilfe von zwei API-Aufrufen. - Der [erste API-Aufruf](https://docs.stripe.com/billing/subscriptions/ng-card.md#pi-create-subscription) sendet Kunden- und Produktinformationen an die [Subscriptions API](https://docs.stripe.com/api/subscriptions.md), um ein Abonnement und einen PaymentIntent in einem Aufruf zu erstellen. - Der zweite API-Aufruf erfolgt an die [Payment Intents API](https://docs.stripe.com/api/payment_intents.md) und [bestätigt die Zahlung](https://docs.stripe.com/billing/subscriptions/ng-card.md#pi-confirm-payment) unter Verwendung der PaymentIntent ID aus der Antwort auf den ersten API-Aufruf. ## Produkt und Preis erstellen [Dashboard] [Produkte](https://docs.stripe.com/api/products.md) stehen für den von Ihnen angebotenen Artikel oder Dienst. [Preise](https://docs.stripe.com/api/prices.md) geben an, wie viel und wie häufig Sie für ein Produkt berechnen. Dies schließt ein, wie viel ein Produkt kostet, welche Währung Sie akzeptieren und ob es sich um eine einmalige oder eine wiederkehrende Zahlung handelt. Wenn Sie nur ein paar wenige Produkte und Preise haben, können Sie diese im Dashboard erstellen und verwalten. In diesem Leitfaden wird ein Stock-Foto-Service als Beispiel verwendet, für den Kund/innen ein monatliches Abonnement mit dem Betrag von 100,000 NGN berechnet werden. Um dies zu modellieren: 1. Gehen Sie zur Seite [Produkte](https://dashboard.stripe.com/products?active=true) und klicken Sie auf **Produkt erstellen**. 1. Geben Sie einen **Namen** für das Produkt an. Sie können optional eine **Beschreibung** hinzufügen und ein Bild des Produkts hochladen. 1. Wählen Sie einen **Produktsteuercode** aus. Erfahren Sie mehr über [Produktsteuercodes](https://docs.stripe.com/tax/tax-codes.md). 1. Wählen Sie **Wiederkehrend** aus. Geben Sie im Anschluss daran **100,000** für den Preis ein und wählen Sie **NGN** als Währung aus. 1. Wählen Sie, ob die **Steuer im Preis berücksichtigt** werden soll. Sie können entweder den Standardwert aus Ihren [Steuereinstellungen](https://dashboard.stripe.com/test/settings/tax) verwenden oder den Wert manuell festlegen. Wählen Sie in diesem Beispiel **Auto** aus. 1. Wählen Sie **Monatlich** als **Abrechnungszeitraum** aus. 1. Klicken Sie auf **Weitere Preisoptionen**. Wählen Sie dann **Pauschalpreis** als Preismodell für dieses Beispiel aus. Erfahren Sie mehr über [Pauschalpreise](https://docs.stripe.com/products-prices/pricing-models.md#flat-rate) und andere [Preismodelle](https://docs.stripe.com/products-prices/pricing-models.md). 1. Fügen Sie eine interne **Preisbeschreibung** und einen [Lookup-Schlüssel](https://docs.stripe.com/products-prices/manage-prices.md#lookup-keys) hinzu, um bestimmte Preise in Zukunft zu organisieren, abzufragen und zu aktualisieren. 1. Klicken Sie auf **Weiter**. Klicken Sie dann auf **Produkt hinzufügen**. Zeichnen Sie nach Erstellen des Produkts und des Preises die Preis-ID auf, sodass Sie diese in nachfolgenden Schritten verwenden können. Die ID wird auf der Preisseite angezeigt und sieht in etwa so aus: `price_G0FvDp6vZvdwRZ`. ## Abonnement erstellen [Serverseitig] Erstellen Sie ein [Abonnement](https://docs.stripe.com/api/subscriptions.md), dem ein Preis und eine Kundin/ein Kunde mit dem Status `incomplete` zugeordnet ist. Hierfür geben Sie den Parameter [payment_behavior](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-payment_behavior) mit dem Wert `default_incomplete` an. Legen Sie den Parameter `payment_settings.save_default_payment_method=on_subscription` fest, um eine Zahlungsmethode bei der Aktivierung eines Abonnements zu speichern. ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d payment_behavior=default_incomplete \ -d "items[0][price]={{PRICE_ID}}" \ -d "payment_settings[save_default_payment_method]=on_subscription" \ -d "expand[0]=latest_invoice.payments" \ -d "expand[1]=latest_invoice.confirmation_secret" ``` Die Antwort enthält die erste [Rechnung](https://docs.stripe.com/api/invoices.md) des *Abonnements*. Diese enthält die Payments der Rechnung, darunter einen Standard-PaymentIntent, den Stripe für diese Rechnung generiert hat, und das Bestätigungsgeheimnis, das Sie auf Client-Seite verwendet haben, um den Prozess der Zahlung sicher abzuschließen, anstatt das gesamte PaymentIntent-Objekt zu übergeben. Sie erhalten die PaymentIntent ID, die Sie verwenden müssen, um eine Zahlung von `latest_Rechnung.Payments` zu bestätigen. Geben Sie das `latest_Rechnung.confirmation_secret.client_secret` an das Frontend zurück, um die Zahlung abzuschließen. Erfahren Sie, wie Sie [ein Abo mit einem kostenlosen Testzeitraum erstellen](https://docs.stripe.com/billing/subscriptions/trials.md). ## Zahlungen bestätigen [Serverseitig] Bestätigen Sie eine Zahlung mit [PaymentIntents](https://docs.stripe.com/api/payment_intents.md) unter Verwendung der PaymentIntent-ID aus der Abonnement-Antwort. Fügen Sie die PaymentIntent-ID zum URL-Pfad hinzu und legen Sie den Wert des Parameters `payment_method_types` auf `ng_card` fest: ```curl curl https://api.stripe.com/v1/payment_intents/:id/confirm \ -u "<>:" \ -d "payment_method_data[type]=ng_card" \ --data-urlencode "return_url=https://www.stripe.com" \ -d "mandate_data[customer_acceptance][type]=online" \ -d "mandate_data[customer_acceptance][online][ip_address]=127.0.0.0" \ -d "mandate_data[customer_acceptance][online][user_agent]=device" \ -d "mandate_data[customer_acceptance][accepted_at]=1660000000" ``` Die PaymentIntent-Antwort enthält den Status `requires_action`. Das bedeutet, dass sich die Kundinnen/Kunden bei unserem lokalen Verarbeiter authentifizieren müssen, um den PaymentIntent abzuschließen. Nach erfolgreicher Zahlung wird das Abonnement aktiv und speichert die Zahlungsmethode als Standard-Zahlungsmethode. # Von Stripe gehostete Seite > This is a Von Stripe gehostete Seite for when api-integration is checkout. View the full page at https://docs.stripe.com/billing/subscriptions/ng-card?api-integration=checkout. Sie können die [Checkout API](https://docs.stripe.com/api/checkout/sessions.md) verwenden, um ein Abonnement mit einer vorgefertigten Bezahlseite zu erstellen und zu bestätigen. ## Produkt und Preis erstellen [Dashboard] [Produkte](https://docs.stripe.com/api/products.md) stehen für den von Ihnen angebotenen Artikel oder Dienst. [Preise](https://docs.stripe.com/api/prices.md) geben an, wie viel und wie häufig Sie für ein Produkt berechnen. Dies schließt ein, wie viel ein Produkt kostet, welche Währung Sie akzeptieren und ob es sich um eine einmalige oder eine wiederkehrende Zahlung handelt. Wenn Sie nur ein paar wenige Produkte und Preise haben, können Sie diese im Dashboard erstellen und verwalten. In diesem Leitfaden wird ein Stock-Foto-Service als Beispiel verwendet, für den Kund/innen ein monatliches Abonnement mit dem Betrag von 100,000 NGN berechnet werden. Um dies zu modellieren: 1. Gehen Sie zur Seite [Produkte](https://dashboard.stripe.com/products?active=true) und klicken Sie auf **Produkt erstellen**. 1. Geben Sie einen **Namen** für das Produkt an. Sie können optional eine **Beschreibung** hinzufügen und ein Bild des Produkts hochladen. 1. Wählen Sie einen **Produktsteuercode** aus. Erfahren Sie mehr über [Produktsteuercodes](https://docs.stripe.com/tax/tax-codes.md). 1. Wählen Sie **Wiederkehrend** aus. Geben Sie im Anschluss daran **100,000** für den Preis ein und wählen Sie **NGN** als Währung aus. 1. Wählen Sie, ob die **Steuer im Preis berücksichtigt** werden soll. Sie können entweder den Standardwert aus Ihren [Steuereinstellungen](https://dashboard.stripe.com/test/settings/tax) verwenden oder den Wert manuell festlegen. Wählen Sie in diesem Beispiel **Auto** aus. 1. Wählen Sie **Monatlich** als **Abrechnungszeitraum** aus. 1. Klicken Sie auf **Weitere Preisoptionen**. Wählen Sie dann **Pauschalpreis** als Preismodell für dieses Beispiel aus. Erfahren Sie mehr über [Pauschalpreise](https://docs.stripe.com/products-prices/pricing-models.md#flat-rate) und andere [Preismodelle](https://docs.stripe.com/products-prices/pricing-models.md). 1. Fügen Sie eine interne **Preisbeschreibung** und einen [Lookup-Schlüssel](https://docs.stripe.com/products-prices/manage-prices.md#lookup-keys) hinzu, um bestimmte Preise in Zukunft zu organisieren, abzufragen und zu aktualisieren. 1. Klicken Sie auf **Weiter**. Klicken Sie dann auf **Produkt hinzufügen**. Zeichnen Sie nach Erstellen des Produkts und des Preises die Preis-ID auf, sodass Sie diese in nachfolgenden Schritten verwenden können. Die ID wird auf der Preisseite angezeigt und sieht in etwa so aus: `price_G0FvDp6vZvdwRZ`. ## Checkout-Sitzung erstellen [Serverseitig] Bevor Sie Zahlungen mit Naira-Karten über Stripe Checkout annehmen können, müssen Ihre Kundinnen/Kunden Sie zur Verwendung ihrer nigerianischen Kreditkarte für zukünftige Zahlungen autorisieren. Fügen Sie Ihrer Website eine Schaltfläche zum Bezahlen hinzu, die einen serverseitigen Endpoint aufruft, um eine [Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions.md) zu erstellen. ```html Checkout
``` Erstellen Sie eine Checkout-Sitzung im `subscription`-Modus, um die erforderlichen Informationen zu erfassen. Leiten Sie Ihre Kundinnen und Kunden nach dem Erstellen der Checkout-Sitzung an die in der Antwort zurückgegebene [Checkout-Sitzungs-URL](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-url) weiter. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ --data-urlencode "success_url=https://example.com/success" \ -d "line_items[0][price]={{RECURRING_PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "payment_method_types[0]=card" \ -d "payment_method_types[1]=ng_card" \ -d mode=subscription ``` ## Integration testen [Serverseitig] Wählen Sie „Naira-Karten“ als Zahlungsmethode aus und klicken Sie dann auf **Abonnieren**. Sie können die erfolgreiche Zahlung testen, indem Sie die Zahlung auf der Weiterleitungsseite authentifizieren. Der PaymentIntent wechselt von `requires_action` zu `succeeded`.