Stripe

Parameter

• publishable_key Publishable key
• secret_key Secret key
• payment_methods Liste der akzeptierten Zahlungsmethoden.
  Eine Auflistung aller möglich Zahlungsoptionen findet sich in den Stripe API Docs.
  Derzeit offiziell von Cofys unterstützt werden aber nur die folgenden:
  • card Kreditkarte
  • giropay Giropay (Deutschland)
  • ideal iDEAL (Niederlande)
  • p24 Przelewy24 (Polen)
  • sepa_debit SEPA (Europa)
  • sofort Sofortüberweisung (Deutschland)
• webhook_secret_keys Signatur-Geheimnis

Registrierung

Registrieren

Die Registrierung erfolgt auf https://dashboard.stripe.com/register.

Account bestätigen

Anschließend muss der Account per E-Mail bestätigt werden. Erfolgt keine Aufforderung, kann dies unter https://dashboard.stripe.com/test/email_verification_required getan werden.

Firmeninformationen hinterlegen

Sobald der Account bestätigt ist, müssen unter https://dashboard.stripe.com/account/onboarding/ die Informationen der Firma hinterlegt werden. Eine Registrierung als natürliche Person ist möglich.

Business details

Unter dem Punkt Business details sollte als Industry Event ticketing angegeben werden.

Fulfillment details

Unter dem Punkt Fulfillment details sollte für Do you sell physical goods? nein und für On average, how long after paying will your customers typically receive their goods or services? Within one day angegeben werden.

Bank details

Eine Registrierung mit N26 Bankkonten ist derzeit seitens Stripe nicht möglich.

Erscheinungsbild

Unter https://dashboard.stripe.com/settings/branding kann das Erscheinungsbild der Checkout Seite angepasst werden.

Zugangsdaten erzeugen

Zur Nutzung ist ein aktiviertes Konto bei Stripe nötig.

Anschließend kann auf https://dashboard.stripe.com/apikeys im Bereich Standard keys ein Publishable / Secret Key Paar erzeugt werden. Wichtig ist, dass der Button View test data deaktiviert ist.

Achtung Der Secret Key wird nur ein Mal angezeigt.

Wenn ein neuer Key benötigt wird, kann über das Menü (Punkte) und die Option Roll key... ein neuer erzeugt werden.
Der Wert Expiration muss dabei auf now gesetzt werden.

Webhooks erstellen

Damit Cofys über Änderungen am Zahlstatus informiert wird, muss ein Webhook erstellt werden. Dazu im Stripe Dashboard unten links auf Entwickler/innen > Webhooks oder direkt auf https://dashboard.stripe.com/webhooks gehen.
Dann auf Ziel hinzufügen klicken. Alle Standardeinstellungen können so beibehalten werden.

Unter Ereignisse folgende Ereignisse auswählen:

payment_intent.canceled
checkout.session.completed

Anschließend auf Weiter klicken.

Als Zieltyp Webhook-Endpoint wählen und auf Weiter klicken.

Bei Endpoint-URL folgende URL eintragen:

https://<COFYS DOMAIN>/api/v2/payments/stripe/webhook/

<COFYS DOMAIN> mit dem Domainnamen des Cofys Instanzen ersetzen.
Anschließend auf Ziel erstellen klicken.

In der nun angezeigten Ansicht unter Details zum Ziel das Signatur Geheimnis kopieren als Parameter webhook_secret_key verwenden.