Prerequisiti
Per completare questa guida, devi aver completato quanto segue:
- Informazioni sulle norme relative ai pagamenti.
- È stata completata la porzione Esporta feed dell'integrazione E2E.
Di seguito sono riportati i tipi di pagamento supportati per questo componente aggiuntivo:
- Pagamento anticipato
- Tariffa per mancato arrivo / Commissione di annullamento
- Deposito
- Richiesta carta di credito
Tutti i casi d'uso per i pagamenti sono estensioni del caso d'uso senza pagamenti/pagamento all'arrivo (che non richiede alcuna configurazione di pagamento), quindi questo tutorial inizierà descrivendo quella configurazione e trattando le altre configurazioni come estensioni.
Pagamento anticipato
Questa configurazione viene utilizzata per specificare che l'importo del servizio deve essere
pagato per intero al momento della prenotazione. Il pagamento anticipato viene specificato a livello di
disponibilità tramite il campo payment del feed Avaibility.
{
"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"
}
}
}
}]
}
Tariffa per mancato arrivo
Le tariffe per mancata partecipazione possono essere addebitate a un utente se non partecipa alla prenotazione o se annulla dopo il periodo di annullamento. Se non viene specificato alcun periodo di annullamento, verrà utilizzata per impostazione predefinita l'ora di inizio dello slot.
Per specificare una tariffa per il mancato arrivo, devi includere il campo no_show_fee nel feed di servizio, come mostrato nell'esempio seguente:
{
"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"
}
}
Nell'esempio, il partner o il commerciante sono autorizzati ad addebitare un addebito a tariffa fissa di 25 $, come specificato nel campo no_show_fee.fee.price_micros, se il titolare dell'appuntamento non partecipa all'appuntamento. Questa tariffa può essere addebitata anche se l'utente annulla l'appuntamento entro 4 ore (14.400 secondi) prima dell'appuntamento, come specificato nel campo scheduling_rules.min_advance_online_canceling.
Per informazioni su come è possibile definire le tariffe per il mancato arrivo nel feed di disponibilità, consulta la sezione Sostituire i prezzi a livello di disponibilità.
La tariffa di mancato arrivo può essere configurata facoltativamente in modo che venga addebitata a persona per la prenotazione. In questo caso, no_show_fee.fee.fee_type può essere impostato su
PER_PERSON.
Deposito
Gli accrediti vengono utilizzati per riscuotere l'addebito iniziale come requisito per una prenotazione. L'acconto può essere addebitato al momento della prenotazione o in un secondo momento. Potresti dover definire i termini in base ai quali un deposito può essere rimborsato e quando una prenotazione può essere annullata online.
Per specificare un versamento, nel feed di servizio devi includere il campo deposit, come mostrato nell'esempio seguente:
{
"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 questo esempio, min_advance_online_canceling definisce la finestra di annullamento, mentre deposit.min_advance_cancellation_sec definisce quando l'acconto è rimborsabile. Tieni presente che nell'esempio un deposito può
specificare un orario di annullamento separatamente dai termini del rimborso. In questo caso, un utente potrà annullare il servizio online con un massimo di 24 ore di anticipo (86.400 secondi). In questo modo, il commerciante viene informato direttamente in caso di eventuali annullamenti tardivi. Tuttavia, l'utente potrebbe comunque avere diritto a un rimborso sul suo
acconto fino a 4 ore prima (14.400 secondi) prima della prenotazione (contattando te o il commerciante per l'annullamento), che verrà mostrato nei
termini al momento del pagamento e nell'email di conferma.
Per scoprire come i depositi possono essere definiti a livello di disponibilità, consulta la sezione Sostituire i prezzi a livello di disponibilità.
Inoltre, come le commissioni per il mancato arrivo, è possibile addebitare un deposito sia a tariffa fissa sia a una tariffa a persona. In questo caso, il bonifico è un tasso fisso di
25 $, come specificato da "deposit_type": "FIXED_RATE_DEFAULT". Se la prenotazione include il numero di persone, è possibile specificare il deposito come deposito a persona impostando "deposit_type": "PER_PERSON".
Richiedi carta di credito
Un servizio potrebbe richiedere una carta di credito come metodo aggiuntivo per verificare l'identità. Tuttavia, non deve essere utilizzato per pagamenti anticipati, versamenti o commissioni per no show. Se questi casi d'uso sono necessari, devono essere configurati in modo esplicito. Richiedere una carta di credito spesso determina un calo significativo delle prenotazioni per questo servizio.
Per richiedere il pagamento di una carta di credito al momento del pagamento, devi impostare il campo
require_credit_card su REQUIRE_CREDIT_CARD_ALWAYS.
{
"merchant_id": "merchant-1",
"service_id": "reservation",
"name": "reservation",
"description": "Food reservation",
"require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}
Override dei prezzi a livello di disponibilità
La struttura dei prezzi e delle tariffe viene specificata a livello di servizio. Nella maggior parte dei casi, dovrebbe essere utilizzato questo prezzo a livello di servizio. Tuttavia, ha senso modificare la struttura dei pagamenti per determinate aree di disponibilità. Ad esempio, le seguenti situazioni potrebbero essere gestite sostituendo prezzi o commissioni a livello di disponibilità:
- I prezzi vengono ridotti il martedì e aumentano il sabato.
- Non è previsto alcun costo per la disponibilità dalle 17:00 alle 19:00.
- Sono richiesti versamenti per il numero di partecipanti maggiore di 6.
- Le prenotazioni in una determinata camera richiedono una carta di credito.
La tabella dei tipi di pagamento elenca, per ciascun metodo di pagamento / tariffa, il campo da utilizzare nel feed di disponibilità per sostituire la definizione del livello di servizio.
| Tipo di pagamento | Definizione del feed | Sostituibile? |
|---|---|---|
| Pagamento anticipato | Availability.prepayment | Non sostituibile |
| Commissione per mancato arrivo | Service.no_show_fee | Availability.no_show_fee |
| Deposito | Service.deposit | Availability.deposit |