Cierre del pedido
POST
Elegir la forma de pago
POST /api/checkout/set-payment-option
Descripción
Guarda con qué piensa pagar el cliente su pedido.
Detalles
Registra la forma de pago que el cliente eligió para que el equipo sepa qué esperar, sin cobrar nada todavía. Solo acepta las formas habilitadas para ese canal. Con pago en línea exige el medio concreto (Nequi o Bancolombia), y con pago en efectivo al recibir guarda con cuánto paga, que no puede ser menor al total. En un domicilio no acepta pagar en caja. En un pedido de grupo fuera del local, solo quien eligió cómo pagar puede cambiarlo.
Permisos requeridos
auth-order
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| paymentOptionType | string | Sí |
enum:gateway,whatsapp_transfer,pay_at_register,cash_on_delivery,pay_on_pickup,pay_at_end,room_charge
|
| paymentMethodCode | string | No |
enum:NEQUI,BANCOLOMBIA_TRANSFER
|
| cashTenderedCents | int | No |
min_value:0
|
Respuesta
Campos que devuelve dentro de data. Nada fuera de esta lista sale en la respuesta.
| Campo | Tipo | Descripción |
|---|---|---|
| paymentOptionType | string | Forma de pago elegida |
| paymentMethodCode | string Admite vacío | Medio de pago en línea elegido |
| cashTenderedCents | int Admite vacío | Con cuánto pagas en efectivo, en centavos |
Ejemplo de request
curl -X POST https://restofy.pro/api/checkout/set-payment-option \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"paymentOptionType": "string"
}'
Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-10-09T02:12:12Z
HTTP 200
Request
{
"paymentOptionType": "pay_on_pickup"
}
Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"paymentOptionType": "pay_on_pickup",
"paymentMethodCode": null,
"cashTenderedCents": null
}
}