Restofy Docs
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
    }
}