Zahlungen mit Alma annehmen

So richten Sie Ihre Integration mit Alma ein.

Web

Mobil

Bei Alma handelt es sich um eine Zahlungsmethode für die einmalige Nutzung, bei der Kundinnen/Kunden ihre Zahlungen in 2, 3 oder 4 Raten begleichen können. Bei Alma werden Kundinnen/Kunden zur Autorisierung der Zahlungen von Ihrer Website oder App weitergeleitet und dann wieder auf Ihre Website bzw. App zurückgeleitet. Dort werden Sie sofort benachrichtigt, ob die Zahlung erfolgreich war oder fehlgeschlagen ist.

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:

PaymentIntent erstellen
Serverseitig

Ein PaymentIntent ist ein Objekt, das Ihre Absicht darstellt, eine Zahlung von Ihrem Kunden/Ihrer Kundin einzuziehen und den Lebenszyklus des Zahlungsvorgangs verfolgt. 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 alma der Liste der Arten der Zahlungsmethoden hinzu.

Der PaymentIntent enthält ein Client-Geheimnis. Senden Sie das Client-Geheimnis an Ihren Client, um Zahlungen sicher abzuschließen, anstatt das gesamte PaymentIntent-Objekt zu übergeben.

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

Weiterleiten zu Alma
Clientseitig

Wenn Kundinnen/Kunden über das „Click to Pay“-Verfahren mit Alma 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 Alma-Weiterleitung zu verarbeiten. Fügen Sie eine return_url hinzu, um festzulegen, wohin Stripe Kundinnen/Kunden weiterleitet, nachdem sie ihre Zahlung abgeschlossen haben.

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: 'alma',
      },
      // 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. 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 den `PaymentIntent`.
`payment_intent_client_secret`	Das Client-Geheimnis des `PaymentIntent`-Objekts.

OptionalWeiterleitung manuell verarbeiten
Serverseitig

OptionalEreignisse nach der Zahlung verarbeiten

Unterstützte Währungen

Sie können Alma-Zahlungen in den Währungen erstellen, die Ihrem Land zugeordnet sind. Die lokale Standardwährung für Alma ist eur und auch Kundinnen/Kunden wird ihr Kaufbetrag in eur angezeigt.

Währung	Land
`eur`	Frankreich, Italien, Spanien, Niederlande, Belgien, Luxemburg

Zahlungen mit Alma annehmen

So richten Sie Ihre Integration mit Alma ein.

Stripe einrichtenServerseitig

PaymentIntent erstellenServerseitig