Dejar propina en el pedido
POST /api/site-tips/set-order-tip
Descripción
Guarda la propina que el cliente elige para su pedido, como porcentaje o monto, y recalcula el total.
Detalles
Guarda la propina que el cliente decide dejar en su pedido, indicada como un porcentaje o como un monto. Solo aplica cuando la propina es voluntaria en ese canal; si es obligatoria o no aplica, no se puede cambiar. El monto se redondea según lo que definió el restaurante y se recalcula el total. Devuelve el desglose de importes actualizado.
Permisos requeridos
public
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| slug | string | Sí |
min:1
max:63
|
| orderUuid | string | Sí |
min:36
max:36
|
| tipType | string | Sí |
max:10
|
| amountCents | int | No |
min_value:0
|
| percent | int | No |
min_value:0
max_value:100
|
Ejemplo de request
curl -X POST https://restofy.pro/api/site-tips/set-order-tip \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"slug": "string",
"orderUuid": "string",
"tipType": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"slug": "restofy_test_sitetiptest_9498_1788885301_tenant",
"orderUuid": "98c922c3-2008-4743-b1b6-74cca0b267b8",
"tipType": "percent",
"percent": 10
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"totals": {
"productsCents": 2300000,
"taxInclusionMode": "inclusive",
"discountCents": 0,
"tipAmountCents": 230000,
"tipModeApplied": "voluntary",
"isTipOverridden": 1,
"deliveryFeeCents": 0,
"deliveryZoneId": null,
"deliveryModeApplied": "disabled",
"grandTotalCents": 2530000,
"balanceCents": 230000,
"paymentStatus": "unpaid"
}
}
}