„Pay with Crypto“ integrierenÖffentliche Vorschau

Beginnen Sie mit der Annahme von Krypto, indem Sie „Mit Krypto bezahlen“ integrieren.

Pay with Crypto funktioniert mit Checkout, Elements oder kann direkt über die Payment Intents API integriert werden. Wenn Sie eine Connect-Plattform sind, finden Sie weitere Informationen unter Connect-Support.

When integrated, the option to pay with crypto appears in your checkout page, redirecting customers to a page hosted by crypto.link.com for payment completion. There, your customers can connect their wallet, and save and reuse their account using Link. You’re immediately notified if the payment succeeds or fails. Before you get started, see our Pay with Crypto demo.

Lassen Sie Ihre Nutzer/innen mit Krypto bezahlen

Integrieren Sie „Pay with Crypto“ direkt über die Payment Intents API. Bevor Sie einen PaymentIntent erstellen, aktivieren Sie Krypto in Ihren Zahlungsmethodeneinstellungen.

Stripe einrichten
Serverseitig

Erstellen Sie zunächst ein Stripe-Konto oder melden Sie sich an.

Verwenden Sie unsere offiziellen Bibliotheken, um von Ihrer Anwendung aus auf die Stripe API zuzugreifen:

Payment Intent erstellen und das Client-Geheimnis abrufen
Serverseitig

Das PaymentIntent-Objekt stellt Ihre Absicht dar, eine Kundenzahlung 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 crypto zur Liste der payment_method_types hinzu.

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

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

Zu „Pay with Crypto“ weiterleiten

Verwenden Sie Stripe.js, um die Zahlung an Stripe zu senden, wenn ein Kunde/eine Kundin Krypto als Zahlungsmethode auswählt. 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.

<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/v3/"></script>
</head>

Erstellen Sie auf Ihrer Bezahlseite mit dem folgenden JavaScript eine Instanz von Stripe.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 „Pay with Crypto“-Weiterleitung zu handhaben. Fügen Sie eine return_url hinzu, um festzulegen, wohin Stripe die Kundinnen/Kunden nach Zahlungsabschluss weiterleitet.

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: 'crypto',
      },
      // 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 Weiterleitungsvorgangs bestehen.

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

OptionalEreignisse nach der Zahlung verarbeiten

Integration testen

Test your Pay with Crypto integration with your test API keys by viewing the redirect page. You can test the successful payment case by authenticating the payment on the redirect page. The PaymentIntent transitions from requires_action to succeeded.

To test the case where the user fails to authenticate:

Use your test API keys and view the redirect page.
On the redirect page, click Fail test payment.

The PaymentIntent transitions from requires_action to requires_payment_method. For manual capture PaymentIntents in test mode, the uncaptured PaymentIntent auto-expires seven days after successful authorization.