Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Zahlungsmethoden
Zahlungsschnittstellen
Zahlungsszenarien
Präsenzzahlungen
Mehr als Zahlungen

GrabPay-Zahlungen annehmen

So akzeptieren Sie Zahlungen per GrabPay, einer gängigen Zahlungsmethode in Südostasien.

Notiz

Abonnements und GrabPay für künftige Zahlungen werden derzeit nicht unterstützt. Wenden Sie sich an den Stripe-Support bei Fragen zu diesen Funktionen.

Bei GrabPay handelt es sich um eine Zahlungsmethode für die einmalige Nutzung. Bei Zahlungen mit GrabPay werden Kund/innen zur Autorisierung der Zahlung von Ihrer Anwendung zu GrabPay geleitet und dann wieder auf Ihre Anwendung zurückgeleitet, wo Sie eine sofortige Benachrichtigung über den Erfolg oder das Fehlschlagen der Zahlung erhalten.

Notiz

Erfahren Sie mehr zur Aktivierung von GrabPay im Dashboard.

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
# Available as a gem
sudo gem install stripe
Gemfile
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Erstellen Sie ein PaymentIntent
Serverseitig

Ein PaymentIntent stellt Ihre Absicht dar, Zahlungen von Kundinnen und Kunden einzuziehen, und dokumentiert den gesamten Zahlungsvorgang.

Erstellen Sie einen PaymentIntent auf Ihrem Server und geben Sie den einzuziehenden amount und die Währung sgd oder myr ein. Beachten Sie, dass es keinen Mindestabbuchungsbetrag für GrabPay gibt, sodass der Zahlungsbetrag durchaus so gering wie 1 sein kann. Falls Sie bereits eine Payment Intents-Integration haben, fügen Sie der Liste der Zahlungsmethodentypen grabpay hinzu.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_types[]"=grabpay \
  -d amount=1099 \
  -d currency=sgd

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
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
})();

Zahlung an Stripe senden
Clientseitig

Wenn Kundinnen/Kunden über das „Click to Pay“-Verfahren mit GrabPay 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'
);

Um eine Zahlung auf Client-Seite zu erstellen, fügen Sie die Schaltfläche Pay with GrabPay hinzu und verwenden stripe.confirmGrabPayPayment, um die Weiterleitung von Ihrer Seite zu verarbeiten und die Zahlung zu ermöglichen.

checkout.html
<button type="button" id="grabpay-button">Pay with GrabPay</button>
<div id="error-message"></div>
client.js
const button = document.getElementById('grabpay-button');

button.addEventListener('click', async function() {
  // By this point, the PaymentIntent should have already been created
  // Pass the clientSecret of the PaymentIntent to confirmGrabPayPayment

  stripe.confirmGrabPayPayment(clientSecret, {
    // Return URL where the customer should be redirected after the authorization
    return_url: 'https://example.com/checkout/complete',
  });
});

Übergeben Sie das Client-Geheimnis des in Schritt 2 erstellten PaymentIntent-Objekts nach stripe.confirmGrabPayPayment.

Fügen Sie dieser Funktion außerdem eine return_url hinzu, um das Ziel anzugeben, an das Nutzer/innen weitergeleitet werden, nachdem sie die Zahlung auf der Website von Grab durchgeführt haben.

Wenn Ihr Kunde/Ihre Kundin eine Zahlung übermittelt, leitet Stripe ihn an die return_url weiter und fügt die folgenden URL-Abfrageparameter ein. Die Rückgabeseite kann diese nutzen, um den Status des PaymentIntent abzurufen, damit der Kunde/die Kundin den Zahlungsstatus anzeigen kann.

Wenn Sie die return_url angeben, können Sie auch Ihre eigenen Abfrageparameter für die Verwendung auf der Rückgabeseite anhängen.

ParameterBeschreibung
payment_intentDie eindeutige ID für den PaymentIntent.
payment_intent_client_secretDas Client-Geheimnis des PaymentIntent-Objekts. Bei Abonnementintegrationen wird dieses client_secret auch über confirmation_secret im Invoice-Objekt sichtbar gemacht

Wenn Kundinnen und Kunden auf Ihre Seite weitergeleitet werden, können Sie payment_intent_client_secret nutzen, um den PaymentIntent abzufragen und Ihren Kundinnen und Kunden den Transaktionsstatus anzuzeigen.

order_confirmation.html
<h2>Payment result</h2>
<div class="payment-result">
</div>

<script>
  // Check if we're returning from a redirect.
  const url = new URL(window.location.href);
  const paymentIntentClientSecret = url.searchParams.get(
    "paymentIntentClientSecret"
  );
  if (paymentIntentClientSecret) {
    stripe.retrievePaymentIntent(paymentIntentClientSecret).then(function(result) {
      const paymentIntent = result.paymentIntent;
      document.querySelector(".payment-result").textContent = paymentIntent.status;
    });
  }
</script>

Integration testen

Beim Testen führt Sie die clientseitige Weiterleitung zu einer von Stripe gehosteten Test-Zahlungsseite von GrabPay, auf der Sie die Testzahlung entweder autorisieren oder ablehnen können.

Unterstützte Währungen

Stripe-Nutzer/innen in Malaysia und Singapur können Zahlungen mit GrabPay von Kund/innen aus dem jeweils anderen Land annehmen. Lesen Sie nachfolgend, welche Währungen unterstützt werden und welche Transaktionslimits GrabPay auferlegt:

LandKundenstandortUnterstützte WährungTransaktionslimits
Singapur (SG)Singapur (SG)SGDGrabPay SG
Malaysia (MY)Malaysia (MY)MYRGrabPay MY
War diese Seite hilfreich?
JaNein