PayNow-Zahlung annehmen

Akzeptieren Sie Zahlungen mit PayNow, einem in Singapur beliebten Geldtransferdienst.

PayNow ist eine Zahlungsmethode zur einmaligen Verwendung. Kundinnen/Kunden verwenden ihre bevorzugte App von teilnehmenden Banken und anderen teilnehmenden Finanzinstituten (keine Banken), um den QR-Code zu scannen, der ihnen beim Bezahlvorgang vorgelegt wird, und die Zahlung abzuschließen.

Stripe einrichten

Zunächst benötigen Sie ein Stripe-Konto. Jetzt registrieren.

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

PaymentIntent erstellen
Serverseitig

Ein PaymentIntent ist ein Objekt, das Ihre Absicht, eine Zahlung von Kundinnen und Kunden einzuziehen, darstellt und den gesamten Zahlungsvorgang dokumentiert. Erstellen Sie zunächst einen PaymentIntent auf Ihrem Server und geben Sie den einzuziehenden Betrag und die Währung an. Falls Sie bereits über eine Integration verfügen, die die Payment Intents API verwendet, fügen Sie der Liste der Zahlungsmethoden für Ihren PaymentIntent die Zahlungsmethode paynow 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
})();

QR-Code von PayNow anzeigen
Clientseitig

In diesem Schritt führen Sie PayNow-Zahlungen auf dem Client mit Stripe.js durch. Binden Sie das Stripe.js-Skript auf Ihrer Bezahlseite ein, indem Sie es dem head Ihrer HTML-Datei hinzufügen.

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

Erstellen Sie einen Instanz von Stripe.js mit dem folgenden JavaScript auf Ihrer Bezahlseite.

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

Verwenden Sie stripe.confirmPayNowPayment, um die Zahlung auf der Client-Seite zu bestätigen.

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

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

  // Set the clientSecret here you got in Step 2
  stripe.confirmPayNowPayment(
    clientSecret,
  ).then((res) => {
    if(res.paymentIntent.status === 'succeeded') {
      // The user scanned the QR code
    } else {
      // The user closed the modal, cancelling payment
    }
  });
});

Nach dem Aufruf von confirmPayNowPayment zeigt die Webseite einen QR-Code an. Ihre Kundinnen/Kunden können den QR-Code scannen und die Zahlung mit ihrer bevorzugten Banking-App oder Zahlungs-App authentifizieren. Sie sollten auf der Seite mit dem QR-Code bleiben, bis Stripe die Bestellung ausführt und Sie das Ergebnis der Zahlung kennen.

Bestellung ausführen
Serverseitig

Verwenden Sie eine Methode wie Webhooks, um die Ausführung der Bestellung abzuwickeln, statt sich darauf zu verlassen, dass Ihre Kundinnen/Kunden zur Zahlungsstatusseite zurückkehren. Wenn ein Kunde/eine Kundin die Zahlung abschließt, wechselt der PaymentIntent zu succeeded und gibt das Webhook-Ereignis payment_intent.succeeded aus.

Ihre Integration testen

Während des Tests können Sie den QR-Code mit einer QR-Code-Scanner-App auf Ihrem Mobilgerät scannen. Die Nutzlast des QR-Codes enthält eine URL, die Sie zu einer von Stripe gehosteten Test-Zahlungsseite von PayNow weiterleitet, auf der Sie die Testzahlung entweder autorisieren oder ablehnen können.

Im Live-Modus können Sie den QR-Code mit einer App von teilnehmenden Banken und anderen teilnehmenden Finanzinstituten (keine Banken) scannen.