Zahlungsanbieter
Online-Zahlung mit PayPal, Mollie, Stripe, Braintree und PAYONE über das inwendo Payment Gateway, dazu SEPA-Lastschrift direkt aus vynst.
vynst (inwendo ERP) spricht nie direkt mit PayPal, Mollie oder Stripe. Alle Online-Zahlungen laufen über das inwendo Payment Gateway, einen eigenen Dienst von inwendo. vynst schickt dem Gateway den Betrag und die Rücksprungadressen, das Gateway leitet die Person zum Anbieter weiter und meldet das Ergebnis zurück.
Mitglied ──► Zahlungslink in vynst ──► inwendo Payment Gateway ──► PayPal / Mollie / Stripe / …
▲ │
└──── Benachrichtigung ◄───────┘ (Rechnung bezahlt, storniert, erstattet)Lastschriften laufen dagegen ohne Zahlungsanbieter: vynst erzeugt die SEPA-Datei selbst (pain.008) und reicht sie auf Wunsch per HBCI/FinTS bei der Bank ein.
Anbieter
| Anbieter | Zugangsdaten | Anbindung |
|---|---|---|
| PayPal | Client-ID und Secret (live und Sandbox) | Zugangsdaten |
| Mollie | API-Key (live und Sandbox) | Zugangsdaten oder verbundenes Konto |
| Stripe | Secret- und Public-Key (live und Sandbox) | Zugangsdaten oder verbundenes Konto |
| GoCardless | – | verbundenes Konto |
| Braintree | Merchant-ID, Public- und Private-Key | Zugangsdaten |
| PAYONE | Merchant-, Account- und Portal-ID, Portal-Key | Zugangsdaten |
Welche Zahlungsarten (Karte, PayPal, SEPA, Apple Pay …) angeboten werden, stellt ihr im Konto beim Anbieter ein.
Einrichten
Die Einstellungen liegen in der Verwaltung unter Einstellungen → Abrechnungs-Einstellungen → Online Zahlung. Dafür braucht ihr Administratorrechte und das Recht Abrechnung.
| Feld | Einstellung | Inhalt |
|---|---|---|
| Aktiv | billing_iw_payment_gateway_is_active |
schaltet die Online-Zahlung ein |
| Standard-Anbieter | billing_iw_payment_gateway_default_provider |
paypal, mollie oder stripe |
| Live Betrieb | billing_iw_payment_gateway_is_production |
aus = Sandbox-Zugänge der Anbieter |
| Weiterleitungs-URL | billing_iw_payment_gateway_redirect_url |
Seite nach erfolgreicher Zahlung, Platzhalter [[TOKEN]] |
| Abbruch-URL | billing_iw_payment_gateway_cancel_url |
Seite nach abgebrochener Zahlung |
| Konfiguration für externe Dienste | billing_iw_payment_gateway_provider_configuration |
Zugangsdaten je Anbieter (JSON) |
API-URL und Lizenz-Token des Gateways trägt inwendo bei der Einrichtung ein. Bei Fragen hilft der Support.
Die Zugangsdaten je Anbieter haben diese Form:
{
"provider_mollie": { "live_api_key": "live_…", "sandbox_api_key": "test_…" },
"provider_stripe": { "live_secret_key": "sk_live_…", "live_public_key": "pk_live_…" },
"provider_paypal": { "live_client_id": "…", "live_client_secret": "…" }
}GET /api/billing/payment_gateway/provider_schema.json liefert die erwarteten Felder aller Anbieter.
Verbundene Konten (Stripe, Mollie, GoCardless)
Statt Schlüssel zu kopieren, könnt ihr ein bestehendes Konto beim Anbieter per Login verbinden:
| Aufruf | Zweck |
|---|---|
GET /api/billing/payment_gateway/connections.json |
verbundene Konten anzeigen |
POST /api/billing/payment_gateway/connections/{provider}/authorize.json |
Login beim Anbieter starten; Body {"redirectUrl": "…"}, Antwort enthält die Login-Adresse |
DELETE /api/billing/payment_gateway/connections/{provider}.json |
Verbindung trennen |
GET …/connections/mollie/profiles.json, PUT …/connections/mollie/profile.json |
Mollie-Profil wählen ({"profileId": "pfl_…"}) |
Ablauf einer Zahlung
- Eine Rechnung ist offen und hat eine Zahlungsart mit der Option Extern.
- Das Mitglied öffnet den Zahlungslink der Rechnung (Kunden-App, E-Mail oder Buchung). vynst legt beim Gateway eine Zahlung an und leitet zum Anbieter weiter.
- Nach der Zahlung ruft das Gateway die Benachrichtigungsadresse von vynst auf:
/api/invoice/external/invoice/notify/{token}/SERVICE_PROVIDER_IW_PAYMENT_GATEWAY.json. vynst fragt den Status beim Gateway nach und prüft Betrag und Live-Modus. - Je nach Status:
| Status | Was vynst tut |
|---|---|
SUCCESS |
Rechnung bezahlt, Zahlung gebucht; Proforma-Rechnungen werden zur echten Rechnung, Gutscheine verschickt |
CANCELED |
Rechnung storniert („Storniert durch externen Zahlungsanbieter“), Kontingente und Gutscheine gesperrt |
REFUNDED |
wie CANCELED; war die Rechnung schon bezahlt, entsteht ein Ticket |
Spenden laufen gleich über /api/invoice/external/donation/notify/….
Erstattungen startet ihr beim Anbieter. vynst reagiert auf den Status REFUNDED, kann aber selbst keine Erstattung auslösen.
Online-Zahlung bei Buchungen und Veranstaltungen
| Einstellung | Bedeutung |
|---|---|
event_direct_billing_duration |
Zeitraum, in dem eine Anmeldung online bezahlt werden muss |
event_direct_billing_as_proforma_invoice |
zuerst Proforma-Rechnung, echte Rechnung erst nach Zahlung |
event_direct_billing_auto_request_payment |
Zahlungsaufforderung automatisch nachschicken |
booking_direct_billing_duration |
dasselbe für Raum- und Objektbuchungen |
In der Kunden-App erscheint die Online-Zahlung, sobald das Gateway aktiv ist.
SEPA-Lastschrift
Für Mitgliedsbeiträge ist die Lastschrift meist der günstigere Weg:
- Mandate werden am Abrechnungskonto gespeichert (IBAN, Mandatsreferenz, Datum), auch per Import.
- vynst erzeugt die SEPA-XML-Datei (pain.008) für einen Abrechnungslauf.
- Rücklastschriften und Zahlungseingänge kommen über den Bankimport (CAMT, MT940 oder HBCI/FinTS) zurück und werden automatisch zugeordnet.
API
Die Endpunkte stehen im Bereich Abrechnung.