Requisitos previos
Para completar esta guía, debes haber completado lo siguiente:
- Conocimiento de nuestras Políticas de pago
- Haber completado la parte de Exportar feeds de tu integración de E2E
Estos son los tipos de pago admitidos para este complemento:
- Prepago
- Tarifa por no presentarse o tarifa de cancelación
- Depósito
- Se requiere tarjeta de crédito
Todos los casos de uso de pagos son extensiones del caso de uso sin pagos o pago por llegada (que no requiere configuración de pago), por lo que este instructivo comenzará con la descripción de esa configuración y tratará las demás como extensiones.
Prepago
Esta configuración se usa para especificar que el importe del servicio se debe pagar en su totalidad en el momento de la reserva. El prepago se especifica en el nivel de disponibilidad
a través del 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"
}
}
}
}]
}
Tarifa por no presentarse
Se pueden cobrar tarifas por no presentarse a los usuarios si no asisten a su reserva o si cancelan después del período de cancelación. Si no se especifica un período de cancelación, se usará de forma predeterminada la hora de inicio del horario disponible.
Para especificar una tarifa por no presentarse, en el feed de servicios, debes incluir el campo no_show_fee, como se muestra en el siguiente ejemplo:
{
"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"
}
}
En el ejemplo, el socio o el comercio están autorizados a cobrar un cargo de
tasa fija de USD 25 como se especifica en el campo no_show_fee.fee.price_micros si el
titular de la cita no asiste a la cita. Esta tarifa también puede cobrarse si el usuario cancela dentro de las 4 horas (14,400 segundos) anteriores a la cita, como se especifica en el campo scheduling_rules.min_advance_online_canceling.
Para ver cómo se pueden definir las tarifas por no presentarse en el feed de disponibilidad, consulta Cómo anular precios a nivel de disponibilidad.
De manera opcional, la tarifa por no presentarse se puede configurar para que se cobre la reserva por persona. En este caso, no_show_fee.fee.fee_type se puede establecer como PER_PERSON.
Depósito
Los depósitos se utilizan para cobrar un cargo inicial como requisito para una reserva. Los depósitos se pueden cobrar en el momento de la reserva o en otro momento. Es posible que debas definir en qué condiciones se puede reembolsar un depósito y cuándo se puede cancelar una reserva en línea.
Para especificar un depósito, en el feed de servicios, debes incluir el campo deposit, como se muestra en el siguiente ejemplo:
{
"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"
}
}
En este ejemplo, el min_advance_online_canceling define el período de cancelación y el deposit.min_advance_cancellation_sec define cuándo el depósito es reembolsable. Ten en cuenta que, en el ejemplo, un depósito puede especificar una hora de cancelación por separado de las condiciones de reembolso. En este caso, un
usuario podrá cancelar el servicio en línea hasta 24 horas antes (86,400
segundos). Esto garantiza que se informe directamente al comercio sobre cualquier cancelación tardía. Sin embargo, es posible que el usuario cumpla con los requisitos para obtener un reembolso en su depósito hasta 4 horas antes (14,400 segundos) antes de la reserva (es decir, comunicándose contigo o con el comercio para realizar la cancelación), que se mostrará en las condiciones durante la confirmación de la compra y en el correo electrónico de confirmación.
Para ver cómo se pueden definir los depósitos a nivel de disponibilidad, consulta Cómo anular precios a nivel de disponibilidad.
Además, ten en cuenta que, al igual que las tarifas por no presentarte, se puede cobrar un depósito con una tarifa fija o por persona. En este caso, el depósito es una tarifa fija de USD 25, como lo especifica "deposit_type": "FIXED_RATE_DEFAULT". Si la reserva incluye un tamaño de grupo determinado, establece "deposit_type": "PER_PERSON" para especificar el depósito como por persona.
Solicitar tarjeta de crédito
Un servicio puede requerir una tarjeta de crédito como una forma adicional de verificar la identidad. Sin embargo, no se debe usar para prepago, depósitos ni tarifas por no presentarse. Si esos casos de uso son necesarios, deben configurarse de forma explícita. La solicitud de una tarjeta de crédito suele generar una disminución significativa en las reservas de este servicio.
Para solicitar que se proporcione una tarjeta de crédito durante la confirmación de la compra, debes configurar el 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"
}
Anula precios en el nivel de disponibilidad
La estructura de precios y tarifas se especifica a nivel del Servicio. En la mayoría de los casos, se debe usar este precio a nivel de servicio. Sin embargo, tiene sentido modificar la estructura de pagos para ciertos horarios disponibles. Por ejemplo, las siguientes situaciones podrían manejarse anulando los precios o las tarifas a nivel de disponibilidad:
- Los precios se reducen los martes y aumentan los sábados.
- Se aplican tarifas por no presentarse a la disponibilidad entre las 5:00 p.m. y las 7:00 p.m.
- Solicitar depósitos para grupos con una cantidad mayor de 6 personas.
- Las reservas en una sala determinada requieren una tarjeta de crédito.
En la tabla de tipos de pago, se indica, para cada método de pago o tarifa, qué campo usar en el feed de disponibilidad para anular la definición del nivel de servicio.
| Tipo de pago | Definición del feed | ¿Se puede anular? |
|---|---|---|
| Prepago | Availability.prepayment | No anulable |
| Tarifa por no presentarse | Service.no_show_fee | Availability.no_show_fee |
| Depósito | Service.deposit | Availability.deposit |