Restofy Docs
Disponibilidad por canal POST

Guardar métodos de pago del pedido por enlace

POST /api/fulfillment-config/set-payment-options

Descripción

Define cómo paga el cliente su pedido cuando lo toma por enlace o QR en un canal de venta.

Detalles

* Reemplaza el conjunto de métodos de pago del pedido por enlace de un canal de entrega en un canal de venta. * Cada método puede ser pasarela automática, transferencia con comprobante, pago anticipado en caja, contra entrega, pago al recoger, pagar al final o cargo a la habitación. En la transferencia el número de WhatsApp es opcional. * La pasarela automática exige elegir la caja que factura y cobra el pedido; la secuencia se resuelve automáticamente al aprobarse el pago. * Cada tipo de entrega admite solo los métodos que tienen sentido: contra entrega en domicilio, pago al recoger en para llevar, autoservicio y vehículo, pago anticipado en caja en mesa y autoservicio, pagar al final en mesa y cargo a la habitación en habitación. * Puedes combinar métodos que cobran antes y al recibir en un mismo canal, pero siempre debe quedar al menos uno. * Devuelve el conjunto de métodos ya guardado.

Permisos requeridos

admin.module

Request

Nombre Tipo Requerido Reglas
fulfillmentUuid string Sí
min:36 max:36
channelId int Sí
min_value:1
paymentOptions array No —
paymentOptions[].optionType string Sí
enum:gateway,whatsapp_transfer,pay_at_register,cash_on_delivery,pay_on_pickup,pay_at_end,room_charge
paymentOptions[].paymentMethodId int No
min_value:1
paymentOptions[].cashRegisterId int No
min_value:1
paymentOptions[].whatsappPhone string No
max:20
paymentOptions[].instructions string No
max:2000
paymentOptions[].asksChange int No
enum:0,1

Ejemplo de request

curl -X POST https://restofy.pro/api/fulfillment-config/set-payment-options \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "fulfillmentUuid": "string",
    "channelId": 1
}'

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

Ejemplo de respuesta

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

Request

{
    "fulfillmentUuid": "f600952a-c384-11f1-a755-a2f78ac020f7",
    "channelId": 1,
    "paymentOptions": [
        {
            "optionType": "gateway",
            "paymentMethodId": 14,
            "cashRegisterId": 1
        }
    ]
}

Response

{
    "success": true,
    "message": "Métodos de pago actualizados",
    "data": {
        "paymentOptions": [
            {
                "optionType": "gateway",
                "paymentMethodId": 14,
                "cashRegisterId": 1,
                "whatsappPhone": null,
                "instructions": null,
                "asksChange": 0
            }
        ]
    }
}