Alipay-Zahlung annehmen

Erfahren Sie, wie Sie Alipay-Zahlungen annehmen, einer bei Kund/innen aus China beliebten digitalen Geldbörse.

Web

Mobilgeräte

Bei Alipay handelt es sich um eine Zahlungsmethode für die einmalige Nutzung, bei der Kundinnen/Kunden ihre Zahlungen authentifizieren müssen. Bei Zahlungen werden Kundinnen/Kunden zur Autorisierung der Zahlung mit Alipay von Ihrer Website weggeleitet und dann wieder auf Ihre Website zurückgeleitet, wo Sie eine sofortige Benachrichtigung über den Erfolg oder das Fehlschlagen der Zahlung erhalten.

Stripe einrichten
Serverseitig

Als Erstes 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:

PaymentIntent erstellen
Serverseitig

Ein PaymentIntent ist ein Objekt, das Ihre Absicht darstellt, eine Zahlung von Ihrem Kunden/Ihrer Kundin einzuziehen und verfolgt den Lebenszyklus des Zahlungsvorgangs. Erstellen Sie einen PaymentIntent auf Ihrem Server und geben Sie den einzuziehenden Betrag und eine unterstützte Währung an. Wenn Sie über eine bestehende Payment Intents-Integration verfügen, fügen Sie alipay der Liste der Arten der Zahlungsmethoden 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
})();

An das Alipay-Wallet weiterleiten
Clientseitig

Wenn Kundinnen/Kunden über das „Click to Pay“-Verfahren mit Alipay 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.confirmAlipayPayment auf, um die Alipay-Weiterleitung zu handhaben. Fügen Sie eine return_url hinzu, um festzulegen, wohin Stripe den Kunden/die Kundin weiterleitet, nachdem er/sie die Zahlung abgeschlossen hat.

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.confirmAlipayPayment(clientSecret, {
    // 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 = error.message;
  }
});

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

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

OptionalWeiterleitung manuell handhaben
Serverseitig

Wir empfehlen, die Verarbeitung von Weiterleitungen mit confirmAlipayPayment Stripe.js zu überlassen. Wenn Sie Ihre Kund/innen jedoch manuell weiterleiten müssen:

Geben Sie die URL an, an die Ihre Kund/innen weitergeleitet werden sollen, sobald die Zahlung abgeschlossen ist.

Bestätigen Sie, dass der PaymentIntent sich im Status requires_action befindet. Der Typ für next_action ist alipay_handle_redirect.

"next_action": {
  "type": "alipay_handle_redirect",
  "alipay_handle_redirect": {
    "url": "https://hooks.stripe.com/...",
    "return_url": "https://example.com/checkout/complete"
  }
}

Leiten Sie die Kundin/den Kunden an die in der Eigenschaft next_action angegebene URL weiter.

Bei Abschluss des Bezahlvorgangs werden die Kund/innen an das Ziel return_url weitergeleitet. Die URL-Abfrageparameter payment_intent und payment_intent_client_secret sind enthalten und Sie können wie oben beschrieben Ihre eigenen Abfrageparameter übergeben.

OptionalEreignisse nach 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.

Ereignisse empfangen und Geschäftsaktionen ausführen

Es gibt mehrere Möglichkeiten, Geschäftsaktionen zu empfangen und auszuführen.

Manuell

Verwenden Sie das Stripe-Dashboard, um alle Stripe-Zahlungen anzuzeigen, Zahlungsbelege per E-Mail zu senden, Auszahlungen abzuwickeln oder fehlgeschlagene Zahlungen erneut durchzuführen.

Testzahlungen im Dashboard anzeigen

Benutzerdefinierter Code

Erstellen Sie einen Webhook-Handler, um Ereignisse zu überwachen und benutzerdefinierte asynchrone Zahlungsabläufe zu erstellen. Mit der Stripe-CLI können Sie Ihre Webhook-Integration lokal testen und Fehler beheben.

Nutzerdefinierten Webhook erstellen

Vorgefertigte Apps

Verarbeiten Sie häufige Geschäftsereignisse, wie Automatisierung oder Marketing und Vertrieb durch Integration einer Partneranwendung.

Unterstützte Währungen

Ihr Konto muss über ein Bankkonto für eine der folgenden Währungen verfügen. Sie können Alipay Zahlungen in den Währungen erstellen, die Ihrem Land zugeordnet sind. Die standardmäßige lokale Währungen für Alipay ist cny und Kund/innen sehen ihren Kaufbetrag auch in cny.

Währung	Land
`cny`	Beliebiges Land
`aud`	Australien
`cad`	Kanada
`eur`	Österreich, Belgien, Bulgarien, Zypern, Tschechien, Dänemark, Estland, Finnland, Frankreich, Deutschland, Griechenland, Irland, Italien, Lettland, Litauen, Luxemburg, Malta, Niederlande, Norwegen, Portugal, Rumänien, Slowakei, Slowenien, Spanien, Schweden, Schweiz
`gbp`	Vereinigtes Königreich
`hkd`	Hongkong
`jpy`	Japan
`myr`	Malaysia
`nzd`	Neuseeland
`sgd`	Singapur
`usd`	USA

Wenn Sie ein Konto in einer anderen Währung haben und eine Alipay Zahlung in dieser Währung erstellen möchten, können Sie sich an den Kund/innen-Support wenden. Wir unterstützen gegebenenfalls weitere Währungen je nach Fall.