Prérequis
Pour suivre ce guide, vous devez avoir:
- Compréhension de nos Conditions de paiement.
- Terminer la partie Exporter les flux de votre intégration de bout en bout.
Les types de paiement suivants sont acceptés par ce module complémentaire:
- Paiement d'avance
- Frais de non-présentation / Frais d'annulation
- Deposit
- Carte de paiement requise
Tous les cas d'utilisation des paiements sont des extensions du cas d'utilisation sans paiement/paiement à l'arrivée (qui ne nécessite aucune configuration de paiement). Ce tutoriel commencera donc par décrire cette configuration et traitera les autres comme des extensions.
Paiement d'avance
Cette configuration permet d'indiquer que le montant du service doit être intégralement payé au moment de la réservation. Le prépaiement est spécifié en fonction du niveau de disponibilité via le champ payment du flux 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"
}
}
}
}]
}
Frais de non-présentation
Des frais de non-présentation peuvent être facturés à un utilisateur s'il ne se présente pas à sa réservation ou s'il annule après la période d'annulation. Si aucune période d'annulation n'est spécifiée, l'heure de début du créneau est utilisée par défaut.
Pour définir des frais de non-présentation, vous devez inclure le champ no_show_fee dans le flux de services, comme indiqué dans l'exemple suivant:
{
"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"
}
}
Dans cet exemple, le partenaire ou le marchand est autorisé à facturer un tarif fixe de 25 $, comme spécifié dans le champ no_show_fee.fee.price_micros, si la personne concernée ne participe pas au rendez-vous. Ces frais peuvent également être facturés si l'utilisateur annule l'abonnement dans les quatre heures (14 400 secondes) avant le rendez-vous, comme spécifié dans le champ scheduling_rules.min_advance_online_canceling.
Pour savoir comment définir des frais de non-diffusion dans le flux disponibilité, consultez Remplacer le prix au niveau de la disponibilité.
Vous pouvez éventuellement configurer des frais de non-présentation de sorte qu'ils soient facturés par personne pour la réservation. Dans ce cas, no_show_fee.fee.fee_type peut être défini sur PER_PERSON.
Deposit
L'acompte sert à collecter un débit initial obligatoire pour la réservation. L'acompte peut être débité au moment de la réservation ou ultérieurement. Vous devrez peut-être définir les conditions dans lesquelles l'acompte est remboursable, ainsi que les cas dans lesquels une réservation peut être annulée en ligne.
Pour indiquer un acompte, vous devez inclure le champ deposit dans le flux des services, comme illustré dans l'exemple suivant:
{
"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"
}
}
Dans cet exemple, min_advance_online_canceling définit la période d'annulation et deposit.min_advance_cancellation_sec indique quand l'acompte est remboursable. Notez que, dans cet exemple, un acompte peut spécifier une date d'annulation séparément des conditions de remboursement. Dans ce cas, l'utilisateur peut annuler le service en ligne jusqu'à 24 heures à l'avance (86 400 secondes). Ainsi, le marchand est directement informé de toute annulation tardive. Toutefois, l'utilisateur peut toujours avoir droit à un remboursement de son acompte jusqu'à quatre heures à l'avance (14 400 secondes) avant la réservation (en vous contactant, vous ou le marchand, pour l'annulation). Le remboursement sera indiqué dans les conditions au moment du règlement et dans l'e-mail de confirmation.
Pour savoir comment les acomptes peuvent être définis au niveau de la disponibilité, consultez la section Remplacer les prix au niveau de la disponibilité.
Notez également que, comme pour les frais de non-présentation, une acompte peut être facturée à un tarif fixe ou par personne. Dans ce cas, l'acompte est un taux fixe de 25 $, comme spécifié par "deposit_type": "FIXED_RATE_DEFAULT". Si la réservation inclut un nombre de personnes, l'acompte peut être spécifié en tant qu'acompte par personne en définissant "deposit_type": "PER_PERSON".
Carte de crédit requise
Un service peut exiger une carte de crédit comme moyen supplémentaire de valider l'identité. Toutefois, vous ne devez pas l'utiliser pour les prépaiements, les acomptes ou les frais de non-présentation. Si ces cas d'utilisation sont nécessaires, vous devez les configurer explicitement. Le fait d'exiger une carte de crédit entraîne souvent une baisse significative du nombre de réservations pour ce service.
Pour exiger qu'une carte de crédit soit fournie lors du règlement, vous devez définir le champ require_credit_card sur REQUIRE_CREDIT_CARD_ALWAYS.
{
"merchant_id": "merchant-1",
"service_id": "reservation",
"name": "reservation",
"description": "Food reservation",
"require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}
Remplacer la tarification au niveau de la disponibilité
Le prix et la structure des frais sont définis au niveau du service. Dans la plupart des cas, ces tarifs doivent être appliqués au niveau du service. Toutefois, il est judicieux de modifier la structure de paiement pour certains créneaux de disponibilité. Par exemple, les situations suivantes peuvent être gérées en remplaçant les prix ou les frais au niveau de la disponibilité:
- Les prix sont réduits le mardi et augmentent le samedi.
- L'absence de frais s'applique aux disponibilités entre 17h et 19h.
- Versement obligatoire pour les groupes de plus de six personnes.
- Les réservations pour certaines chambres nécessitent une carte de crédit.
Le tableau des types de paiement répertorie, pour chaque mode de paiement / frais, le champ à utiliser dans le flux disponibilité pour remplacer la définition du niveau de service.
| Type de paiement | Définition du flux | remplaçable ? |
|---|---|---|
| Paiement d'avance | Availability.prepayment | Non remplaçable |
| Frais de en cas de non présentation | Service.no_show_fee | Availability.no_show_fee |
| Deposit | Service.deposit | Availability.deposit |