Voraussetzungen
Um diese Anleitung vollständig nutzen zu können, müssen Sie Folgendes erledigt haben:
- Verständnis unserer Zahlungsrichtlinien
- Sie haben den Teil Feeds exportieren Ihrer E2E-Integration abgeschlossen.
Die folgenden Zahlungsarten werden für dieses Add-on unterstützt:
- Vorauszahlung
- Gebühr bei Nichterscheinen / Stornierungsgebühr
- Anzahlung
- Kreditkarte erforderlich
Alle Anwendungsfälle für Zahlungen sind Erweiterungen des Anwendungsfalls „Keine Zahlungen“/„Pay-on-arrival“, für den keine Zahlungskonfiguration erforderlich ist. Daher wird in dieser Anleitung zuerst diese Konfiguration beschrieben und andere Konfigurationen als Erweiterungen behandelt.
Vorauszahlung
Mit dieser Konfiguration wird angegeben, dass der Preis für die Dienstleistung bei der Buchung vollständig bezahlt werden muss. Die Vorauszahlung wird auf Verfügbarkeitsebene im Feld payment des Feeds Avaibility angegeben.
{
"availability": [{
"merchant_id": "dining-A",
"service_id": "reservation",
"start_sec": 1535853600,
"duration_sec": 2700,
"spots_total": 2,
"spots_open": 2,
"resources": {
"room_id": "A-dining-room",
"room_name": "Wine Tasting Room",
"party_size": 2,
"prepayment": {
"price_info": {
"price": {
"price_micros": 200000000,
"currency_code": "USD",
},
"price_type": "PER_PERSON"
}
}
}
}]
}
Gebühr bei Nichterscheinen
Bei Nichterscheinen kann Nutzern Gebühren in Rechnung gestellt werden, wenn sie nicht zur Reservierung kommen oder nach Ablauf der Stornierungsfrist stornieren. Wenn kein Kündigungsfenster angegeben ist, wird standardmäßig die Startzeit des Slots verwendet.
Wenn du eine Gebühr bei Nichterscheinen angeben möchtest, solltest du im Dienstleistungsfeed das Feld no_show_fee einfügen, wie im folgenden Beispiel gezeigt:
{
"merchant_id": "merchant-1",
"service_id": "service-2-b",
"name": "Reservation",
"description": "A dining reservation",
"price": {
"price_micros": 200000000,
"currency_code": "USD"
},
"scheduling_rules": {
"min_advance_online_canceling": 14400,
},
"no_show_fee": {
"fee": {
"price_micros": 25000000,
"currency_code": "USD"
},
"fee_type": "FIXED_RATE_DEFAULT"
}
}
In diesem Beispiel ist der Partner oder Händler berechtigt, einen Festpreis von 25 $wie im Feld no_show_fee.fee.price_micros angegeben zu berechnen, wenn der Inhaber des Termins nicht am Termin teilnimmt. Diese Gebühr kann auch berechnet werden, wenn der Nutzer innerhalb von 4 Stunden (14.400 Sekunden) vor dem Termin abgesagt, wie im Feld scheduling_rules.min_advance_online_canceling angegeben.
Informationen dazu, wie Gebühren bei Nichterscheinen im Verfügbarkeitsfeed definiert werden können, findest du unter Preise auf Verfügbarkeitsebene überschreiben.
Die Gebühr bei Nichterscheinen kann optional so konfiguriert werden, dass sie für die Reservierung pro Person berechnet wird. In diesem Fall kann no_show_fee.fee.fee_type auf PER_PERSON festgelegt werden.
Anzahlung
Anzahlungen werden verwendet, um eine Erstgebühr als Voraussetzung für eine Buchung zu erheben. Anzahlungen können bei der Buchung oder zu einem späteren Zeitpunkt in Rechnung gestellt werden. Möglicherweise müssen Sie festlegen, zu welchen Bedingungen eine Anzahlung erstattet werden soll und wann eine Buchung online storniert werden kann.
Wenn du eine Anzahlung angeben möchtest, solltest du im Dienstleistungsfeed das Feld deposit einfügen, wie im folgenden Beispiel gezeigt:
{
"merchant_id": "merchant-1",
"service_id": "service-2-b",
"name": "Reservation",
"description": "A dining reservation",
"price": {
"price_micros": 200000000,
"currency_code": "USD"
},
"scheduling_rules": {
"min_advance_online_canceling": 86400,
},
"deposit": {
"deposit": {
"price_micros": 25000000,
"currency_code": "USD",
"min_advance_cancellation_sec": 14400,
},
"deposit_type": "FIXED_RATE_DEFAULT"
}
}
In diesem Beispiel definiert der min_advance_online_canceling die Stornierungsfrist und der deposit.min_advance_cancellation_sec definiert, wann die Anzahlung erstattungsfähig ist. Beachten Sie, dass in diesem Beispiel eine Stornierungszeit unabhängig von den Erstattungsbedingungen in einer Anzahlung angegeben werden kann. In diesem Fall kann ein Nutzer den Dienst bis zu 24 Stunden im Voraus (86.400 Sekunden) online stornieren. So wird der Händler direkt über verspätete Stornierungen informiert. Der Nutzer kann jedoch bis 4 Stunden (14.400 Sekunden) vor der Buchung eine Erstattung für seine Anzahlung erhalten, indem er Sie oder den Händler zur Stornierung kontaktiert. Dies wird in den Bedingungen an der Kasse und in der Bestätigungs-E-Mail angezeigt.
Informationen dazu, wie Anzahlungen auf Verfügbarkeitsebene definiert werden können, finden Sie unter Preise auf der Verfügbarkeitsebene überschreiben.
Beachten Sie auch, dass, wie bei Gebühren bei Nichterscheinen, eine Anzahlung entweder zu einem festen Preis oder zu einem Preis pro Person erhoben werden kann. In diesem Fall beträgt die Anzahlung einen festen Satz von 25 $, wie in "deposit_type": "FIXED_RATE_DEFAULT" angegeben. Wenn die Buchung eine Gruppengröße beinhaltet, kann die Anzahlung als Anzahlung pro Person angegeben werden. Dazu setzen Sie "deposit_type": "PER_PERSON".
Kreditkarte erforderlich
Bei einem Dienst ist möglicherweise als zusätzliche Methode zur Bestätigung der Identität eine Kreditkarte erforderlich. Sie sollte jedoch nicht für Vorauszahlungen, Anzahlungen oder Gebühren bei Nichterscheinen verwendet werden. Wenn diese Anwendungsfälle erforderlich sind, sollten sie explizit konfiguriert werden. Die Angabe einer Kreditkarte führt häufig zu einem deutlichen Rückgang der Buchungen für diese Dienstleistung.
Damit an der Kasse eine Kreditkarte angegeben werden muss, müssen Sie das Feld require_credit_card auf REQUIRE_CREDIT_CARD_ALWAYS setzen.
{
"merchant_id": "merchant-1",
"service_id": "reservation",
"name": "reservation",
"description": "Food reservation",
"require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}
Preise auf Verfügbarkeitsebene überschreiben
Der Preis und die Gebührenstruktur werden auf Serviceebene festgelegt. In den meisten Fällen sollte dieser Preis auf Serviceebene verwendet werden. Es ist jedoch sinnvoll, die Zahlungsstruktur für bestimmte verfügbare Slots zu ändern. In den folgenden Situationen können Sie beispielsweise Preise oder Gebühren auf der Verfügbarkeitsebene überschreiben:
- Die Preise sind dienstags niedriger und samstags höher.
- Bei Nichterscheinen wird eine Gebühr zwischen 17:00 und 19:00 Uhr erhoben.
- Verlangen Sie Anzahlungen ab 6 Personen.
- Für Buchungen in einem bestimmten Zimmer ist eine Kreditkarte erforderlich.
In der Tabelle mit den Zahlungsarten ist für jede Zahlungs-/Gebührenmethode angegeben, welches Feld im Verfügbarkeitsfeed zum Überschreiben der Service Level-Definition verwendet werden soll.
| Zahlungsart | Feeddefinition | Überschreibbar? |
|---|---|---|
| Vorauszahlung | Availability.prepayment | Nicht übersteuerbar |
| Gebühr bei Nichterscheinen | Service.no_show_fee | Availability.no_show_fee |
| Anzahlung | Service.deposit | Availability.deposit |