Restofy Docs
Cierre del pedido POST

Ver la propina del pedido

POST /api/checkout/get-tip

Descripción

Devuelve la propina actual del pedido y las opciones rápidas para elegirla.

Detalles

Retorna la propina vigente, si el restaurante la dejó voluntaria, obligatoria o sin propina, y el total del pedido sin la propina. Con propina voluntaria trae opciones rápidas ya calculadas sobre lo que lleva el pedido, con el mismo redondeo con que se guardan.

Permisos requeridos

auth-order

Request

Este endpoint no recibe parámetros.

Respuesta

Campos que devuelve dentro de data. Nada fuera de esta lista sale en la respuesta.

Campo Tipo Descripción
tipConfigMode string Si la propina es voluntaria, obligatoria o no aplica
tipValueType string Admite vacío Si la propina sugerida es un porcentaje o un monto fijo
tipAmountCents int Propina vigente, en centavos
tipRateBasisPoints int Porcentaje de la propina vigente, en puntos básicos
isTipOverridden bool Si la propina la eligió alguien a mano
maxAmountCents int Propina máxima permitida, en centavos
totalWithoutTipCents int Total del pedido sin la propina, en centavos
options array Opciones rápidas de propina
options[].tipType string Tipo de propina para guardarla
options[].percent int Admite vacío Porcentaje de la opción
options[].amountCents int Monto de la opción, en centavos
options[].isSuggested bool Si es la propina que sugiere el restaurante

Ejemplo de request

curl -X POST https://restofy.pro/api/checkout/get-tip \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>"

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-10-09T02:12:12Z
HTTP 200

Request

[]

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "tipConfigMode": "voluntary",
        "tipValueType": "percentage",
        "tipAmountCents": 50000,
        "tipRateBasisPoints": 1000,
        "isTipOverridden": false,
        "maxAmountCents": 500000,
        "totalWithoutTipCents": 500000,
        "options": [
            {
                "tipType": "none",
                "percent": null,
                "amountCents": 0,
                "isSuggested": false
            },
            {
                "tipType": "percent",
                "percent": 5,
                "amountCents": 25000,
                "isSuggested": false
            },
            {
                "tipType": "percent",
                "percent": 10,
                "amountCents": 50000,
                "isSuggested": true
            },
            {
                "tipType": "percent",
                "percent": 15,
                "amountCents": 75000,
                "isSuggested": false
            }
        ]
    }
}