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. Navigieren Sie zur Seite Produkt hinzufügen.
2. Geben Sie einen Namen für das Produkt an.
3. Geben Sie 100,000 für den Preis ein.
4. Wählen Sie als Währung KRW aus.
5. Klicken Sie auf Produkt speichern.

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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  --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.