Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed Payments
Präsenzzahlungen
Zahlungsmethoden
Zahlungsszenarien
Mehr als Zahlungen

Eine Zahlung mit Samsung Pay in Südkorea annehmen

Samsung Pay ermöglicht es Kundinnen und Kunden in Südkorea, mit dieser lokalen Zahlungsmethode zu bezahlen.

Wenn Kundinnen und Kunden eine Zahlung vornehmen, leiten wir sie an unseren lokalen Abwicklungspartner weiter, um die Zahlung zu authentifizieren und zu autorisieren. Nachdem der Kunde/die Kundin die Zahlung autorisiert hat, leiten wir ihn/sie zurück zu Ihrer Website.

Mithilfe der Payment Intents API können Sie Zahlungen von südkoreanischen Kundinnen/Kunden mit lokalen Karten und lokalen Zahlungsmethoden annehmen.

Stripe einrichten
Serverseitig

Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.

Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API über Ihre Anwendung:

Command Line
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Erstellen Sie ein PaymentIntent
Serverseitig

Ein PaymentIntent ist ein Objekt, das Ihre Absicht darstellt, eine Kundenzahlung einzuziehen, und den Zahlungsvorgang dokumentiert. Um einen PaymentIntent zu erstellen, der eine Zahlung mit samsung_pay akzeptiert, geben Sie den einzuziehenden Betrag, krw als Währung und samsung_pay in der payment_method_types-Liste an. Wenn Sie eine Liste mit Zahlungsmethodentypen haben, die Sie beim Erstellen eines PaymentIntent übergeben, fügen Sie dieser Liste samsung_pay hinzu.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=10000 \
  -d currency=krw \
  -d "payment_method_types[]"=samsung_pay \
  -d "payment_method_data[type]"=samsung_pay

Client-Geheimnis abrufen

Im PaymentIntent ist ein Client-Geheimnis enthalten, das auf dem Client verwendet wird, um Zahlungen sicher abzuschließen. Es gibt verschiedene Verfahren zum Übergeben des Client-Geheimnisses an den Client.

Rufen Sie das Client-Geheimnis von einem Endpoint auf Ihrem Server ab, indem Sie die Browser-Funktion fetch verwenden. Diese Vorgehensweise funktioniert am besten, wenn es sich bei Ihrer Client-Seite um eine einseitige Anwendung handelt, insbesondere wenn sie mit einem modernen Frontend-Framework wie React erstellt wurde. Erstellen Sie den Server-Endpoint, der das Client-Geheimnis bereitstellt:

main.rb
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
get '/secret' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end

Und dann rufen Sie das Client-Geheimnis mit JavaScript auf der Client-Seite ab:

(async () => {
  const response = await fetch('/secret');
  const {client_secret: clientSecret} = await response.json();
  // Render the form using the clientSecret
})();

Stellen Sie sicher, dass Ihre Kundinnen und Kunden die Nutzungsbedingungen verstehen
Clientseitig

Der Abwicklungspartner von Stripe verlangt, dass die Kundinnen und Kunden über die Identität des Abwicklers und dessen Nutzungsbedingungen informiert werden. Sie müssen die folgende Formulierung und den folgenden Link auf Ihrer Bezahlvorgangsseite angeben:

Hinweis

Nach dem Absenden werden Sie weitergeleitet, sodass Sie die nächsten Schritte durchführen können. Diese Transaktion wird über NICEPAY in Übereinstimmung mit den Nutzungsbedingungen.do von NICEPAY abgewickelt.

An lokalen Zahlungsabwickler weiterleiten
Clientseitig

Wenn Kundinnen/Kunden über das „Click to Pay“-Verfahren mit Samsung Pay bezahlen, verwenden Sie Stripe.js, um die Zahlungen an Stripe zu übermitteln. Stripe.js ist die grundlegende JavaScript-Bibliothek für die Erstellung von Zahlungsabläufen. Sie verarbeitet automatisch komplexe Szenarien wie die nachfolgend beschriebene Weiterleitung und ermöglicht die Erweiterung Ihrer Integration durch zusätzliche Zahlungsmethoden. Binden Sie das Stripe.js-Skript in Ihre Bezahlseite ein, indem Sie es im head Ihrer HTML-Datei einfügen.

checkout.html
<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/clover/stripe.js"></script>
</head>

Erstellen Sie auf Ihrer Checkout-Seite mit dem folgenden JavaScript eine Instanz von Stripe.js.

client.js
// Set your publishable key. Remember to change this to your live publishable key in production!
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx'
);

Verwenden Sie das Client-Geheimnis des PaymentIntent und rufen Sie stripe.confirmPayment auf, um die Weiterleitung an die Bezahlseite des lokalen Zahlungsabwicklers durchzuführen. Auf dieser Seite wählt der Kunde/die Kundin seinen/ihren Aussteller aus und autorisiert die Zahlung. Fügen Sie eine return_url hinzu, um festzulegen, wohin Stripe die Kundinnen/Kunden nach Durchführung der Zahlung weiterleitet.

client.js
const form = document.getElementById('payment-form');

form.addEventListener('submit', async function(event) {
  event.preventDefault();

  // Set the clientSecret of the PaymentIntent
  const { error } = await stripe.confirmPayment({
    clientSecret: clientSecret,
    confirmParams: {
      payment_method_data: {
        type: 'samsung_pay',
      },
      // Return URL where the customer should be redirected after the authorization
      return_url: `${window.location.href}`,
    },
  });

  if (error) {
    // Inform the customer that there was an error.
    const errorElement = document.getElementById('error-message');
    errorElement.textContent = result.error.message;
  }
});

Die return_url verweist auf eine Seite auf Ihrer Website, auf der das Ergebnis der Zahlung angezeigt wird. Sie können festlegen, was angezeigt werden soll, indem Sie den Status des PaymentIntent verifizieren. Um den Status zu verifizieren, enthält die Stripe Weiterleitung zum return_url die folgenden URL-Abfrageparameter. Sie können auch Ihre eigenen Abfrageparameter an die return_url anhängen. Sie bleiben während des gesamten Weiterleitungsvorgangs bestehen.

ParameterBeschreibung
payment_intentDie eindeutige ID für den PaymentIntent.
payment_intent_client_secretDas Client-Geheimnis des PaymentIntent-Objekts.

Test integration with Samsung Pay

Testen Sie Ihre Integration mit Samsung Pay mit Ihren Test-API-Schlüsseln, indem Sie die Weiterleitungsseite anzeigen. Sie können die erfolgreiche Zahlung testen, indem Sie die Zahlung auf der Weiterleitungsseite authentifizieren. Der PaymentIntent wechselt von requires_action zu succeeded. Um einen Fall zu testen, in dem sich Kundinnen/Kunden nicht authentifizieren können, verwenden Sie Ihre Test-API Schlüssel und zeigen Sie die Weiterleitungsseite an. Klicken Sie auf der Weiterleitungsseite auf Fehlgeschlagene Testzahlung. Der PaymentIntent wechselt von requires_action zu requires_payment_method.

OptionalEreignisse nach der Zahlung verarbeiten

Stripe übermittelt ein payment_intent.succeeded-Ereignis, wenn die Zahlung abgeschlossen ist. Verwenden Sie im Dashboard einen Webhook oder eine Partnerlösung, um diese Ereignisse zu empfangen und Aktionen auszuführen (Versenden einer Bestellbestätigung per E-Mail an die Kund/innen, Erfassen des Verkaufs in einer Datenbank oder Einleiten des Versandablaufs).

Überwachen Sie diese Ereignisse, statt auf einen Callback vom Client zu warten. Auf dem Client könnte der Kunde/die Kundin das Browserfenster schließen oder die App beenden, bevor der Callback erfolgt ist und böswillige Clients könnten die Antwort manipulieren. Wenn Sie Ihre Integration so einrichten, dass asynchrone Ereignisse überwacht werden, hilft Ihnen dies auch dabei, in Zukunft mehr Zahlungsmethoden zu akzeptieren. Hier erhalten Sie Informationen zu den Unterschieden zwischen allen unterstützten Zahlungsmethoden.

  • Manuelles Bearbeiten von Ereignissen im Dashboard

    Verwenden Sie das Dashboard, um Ihre Testzahlungen im Dashboard anzuzeigen, E-Mail-Belege zu senden, Auszahlungen zu bearbeiten oder fehlgeschlagene Zahlungen erneut zu versuchen.

  • Erstellen eines benutzerdefinierten Webhooks

    Build a custom webhook handler to listen for events and build custom asynchronous payment flows. Test and debug your webhook integration locally with the Stripe CLI.

  • Integrieren einer vorgefertigten App

    Bearbeiten Sie häufige Unternehmensereignisse, wie z. B.Automatisierung oderMarketing und Vertrieb, indem Sie eine Partneranwendung integrieren.