Eine Zahlung mit PAYCO in Südkorea annehmen

Durch die Integration mit PAYCO können Kundinnen und Kunden in Südkorea mit dieser beliebten lokalen Zahlungsmethode 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:

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 payco akzeptiert, geben Sie den einzuziehenden Betrag, krw als Währung und payco 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 payco hinzu.

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:

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 Kundinnen/Kunden auf die Identität des Abwicklers hingewiesen werden und dessen Nutzungsbedingungen verstehen. Sie müssen die folgende Sprache und den folgenden Link auf Ihrer Bezahlseite einfügen:

Notiz

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 PAYCO 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/basil/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: 'payco',
      },
      // 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.

Parameter	Beschreibung
`payment_intent`	Die eindeutige ID für den `PaymentIntent`.
`payment_intent_client_secret`	Das Client-Geheimnis des `PaymentIntent`-Objekts.

Test integration with PAYCO

Testen Sie Ihre Integration mit PAYCO 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.

Eine Zahlung mit PAYCO in Südkorea annehmen

Stripe einrichtenServerseitig

Erstellen Sie ein PaymentIntentServerseitig