Pré-requisitos
Para concluir este guia, você precisa ter:
- Compreensão das nossas políticas de pagamento.
- Concluir a parte Exportar feeds da sua integração E2E.
Estes são os tipos de pagamento compatíveis com este complemento:
- Pré-pagamento
- Taxa de não comparecimento / taxa de cancelamento
- Problemas
- Cartão de crédito obrigatório
Todos os casos de uso para pagamentos são extensões do caso de uso de nenhum pagamento/pagamento na chegada (que não requer configuração de pagamento). Portanto, este tutorial começará descrevendo essa configuração e tratará outras configurações como extensões.
Pré-pagamento
Essa configuração é usada para especificar que o valor do serviço precisa ser pago integralmente no momento da reserva. O pré-pagamento é especificado no nível de disponibilidade no campo payment do 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"
}
}
}
}]
}
Taxa de não comparecimento
As taxas de não comparecimento poderão ser cobradas se o usuário não comparecer à reserva ou cancelar após a janela de cancelamento. Se nenhuma janela de cancelamento for especificada, o padrão será o horário de início do slot.
Para especificar uma taxa de não comparecimento, inclua o campo no_show_fee no feed de serviços, conforme mostrado no exemplo a seguir:
{
"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"
}
}
No exemplo, o parceiro ou o comerciante está autorizado a cobrar uma taxa fixa de US $25, conforme especificado no campo no_show_fee.fee.price_micros se o responsável pelo agendamento não participar do horário. Essa taxa também será cobrada
se o usuário cancelar até 4 horas (14.400 segundos) antes do horário agendado,
conforme especificado no campo scheduling_rules.min_advance_online_canceling.
Para saber como as taxas de não comparecimento podem ser definidas no feed de disponibilidade, consulte Como substituir preços no nível de disponibilidade.
A taxa de não comparecimento pode ser configurada para ser cobrada por pessoa pela reserva. Nesse caso, no_show_fee.fee.fee_type pode ser definido como
PER_PERSON.
Problemas
Os depósitos são usados para coletar uma cobrança inicial como um requisito para uma reserva. Os depósitos podem ser cobrados no momento da reserva ou posteriormente. Talvez seja necessário definir em quais termos o depósito é reembolsável, bem como quando uma reserva pode ser cancelada on-line.
Para especificar um depósito, inclua o campo deposit no feed de serviço, conforme mostrado no exemplo a seguir:
{
"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"
}
}
Neste exemplo, o
min_advance_online_canceling
define a janela de cancelamento e a
deposit.min_advance_cancellation_sec
define quando o depósito é reembolsável. No exemplo, um depósito pode especificar um horário de cancelamento separado dos termos de reembolso. Nesse caso, ele pode cancelar o serviço on-line com até 24 horas de antecedência (86.400 segundos). Isso garante que o comerciante seja informado diretamente sobre cancelamentos
em atraso. No entanto, o usuário ainda pode se qualificar para um reembolso pelo depósito com até 4 horas de antecedência (14.400 segundos) antes da reserva (entrando em contato com você ou com o comerciante para cancelamento), que será mostrado nos termos na finalização da compra e no e-mail de confirmação.
Para ver como os depósitos podem ser definidos no nível de disponibilidade, consulte Substituição de preços no nível de disponibilidade.
Observe também que, assim como as taxas de não comparecimento, é possível fazer a cobrança de um depósito com taxa fixa ou por pessoa. Nesse caso, o depósito é uma taxa fixa de US$ 25, conforme especificado por "deposit_type": "FIXED_RATE_DEFAULT". Se a reserva incluir um número de pessoas grande, o depósito poderá ser especificado como um depósito por pessoa. Para isso, defina "deposit_type": "PER_PERSON".
Exigir cartão de crédito
Um serviço pode exigir um cartão de crédito como forma adicional de verificação de identidade. No entanto, ela não deve ser usada para pré-pagamento, depósitos ou taxas de não comparecimento. Se esses casos de uso forem necessários, eles deverão ser configurados explicitamente. Exigir um cartão de crédito geralmente leva a uma queda significativa nas reservas desse serviço.
Para exigir que um cartão de crédito seja fornecido na finalização da compra, você precisa definir o campo require_credit_card como REQUIRE_CREDIT_CARD_ALWAYS.
{
"merchant_id": "merchant-1",
"service_id": "reservation",
"name": "reservation",
"description": "Food reservation",
"require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}
Substituir preço no nível de disponibilidade
O preço e a estrutura de tarifas são especificados no nível do serviço. Na maioria dos casos, esse preço no nível de serviço deve ser usado. No entanto, faz sentido alterar a estrutura de pagamentos de determinados horários disponíveis. Por exemplo, as seguintes situações podem ser tratadas com a substituição de preços ou taxas no nível de disponibilidade:
- Os preços são reduzidos às terças-feiras e aumentam aos sábados.
- Taxas de não comparecimento se aplicam à disponibilidade entre 17h e 19h.
- Exigir depósitos para grupos maiores que 6.
- É necessário usar um cartão de crédito para fazer reservas em uma determinada sala.
A tabela de tipo de pagamento lista o campo a ser usado no feed de disponibilidade para substituir a definição de nível de serviço para cada forma de pagamento / taxa.
| Tipo de pagamento | Definição do feed | Substituível? |
|---|---|---|
| Pré-pagamento | Availability.prepayment | Não pode ser substituído |
| Taxa de não comparecimento | Service.no_show_fee | Availability.no_show_fee |
| Problemas | Service.deposit | Availability.deposit |