Abonnement mit Kakao Pay einrichten

Produkte stehen für den von Ihnen angebotenen Artikel oder Dienst. Preise 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 KRW berechnet werden. Um dies zu modellieren:

1. Gehen Sie zur Seite Produkte und klicken Sie auf Produkt erstellen.
2. Geben Sie einen Namen für das Produkt an. Sie können optional eine Beschreibung hinzufügen und ein Bild des Produkts hochladen.
3. Wählen Sie einen Produktsteuercode aus. Erfahren Sie mehr über Produktsteuercodes.
4. Wählen Sie Wiederkehrend aus. Geben Sie im Anschluss daran 100,000 für den Preis ein und wählen Sie KRW als Währung aus.
5. Wählen Sie, ob die Steuer im Preis berücksichtigt werden soll. Sie können entweder den Standardwert aus Ihren Steuereinstellungen verwenden oder den Wert manuell festlegen. Wählen Sie in diesem Beispiel Auto aus.
6. Wählen Sie Monatlich als Abrechnungszeitraum aus.
7. Klicken Sie auf Weitere Preisoptionen. Wählen Sie dann Pauschalpreis als Preismodell für dieses Beispiel aus. Erfahren Sie mehr über Pauschalpreise und andere Preismodelle.
8. Fügen Sie eine interne Preisbeschreibung und einen Lookup-Schlüssel hinzu, um bestimmte Preise in Zukunft zu organisieren, abzufragen und zu aktualisieren.
9. 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.

Erstellen Sie einen SetupIntent, um die kundenseitigen Zahlungsmethoden für spätere Zahlungen zu speichern. Der SetupIntent dokumentiert die Schritte dieses Einrichtungsvorgangs.

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d confirm=true \
  --data-urlencode return_url="https://www.stripe.com" \
  -d usage=off_session \
  -d customer=cus_ODQluYFNl44ODI \
  -d "payment_method_data[type]"=kakao_pay \
  -d "payment_method_types[]"=kakao_pay \
  -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 client_secret, einen eindeutigen Schlüssel, den Sie auf der Client-Seite an Stripe.js übergeben müssen, um Ihre Käufer/innen an Kakao Pay weiterzuleiten und Mandate zu autorisieren.

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 https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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, wird die voreingestellte Zahlungsmethode der Kundinnen/Kunden automatisch belastet. War eine Zahlung erfolgreich, so ändert sich der Status im Stripe-Dashboard in Aktiv. 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.

Bestätigen Sie eine Zahlung mit PaymentIntents 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 kakao_pay fest:

curl https://api.stripe.com/v1/payment_intents/:id/confirm \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode return_url="https://www.stripe.com" \
  -d "payment_method_data[]"=type \
  -d "payment_method_data[]"=kakao_pay

Die PaymentIntent-Antwort enthält den Status requires_action. Das bedeutet, dass Ihre Kundinnen und Kunden die Zahlung mit der von ihnen über Kakao Pay 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.