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 una pasarela automática, transferencia por WhatsApp, pago en caja, pago contra entrega o pago al recoger. * La pasarela automática exige elegir la caja que factura y cobra el pedido; la secuencia se resuelve automáticamente al aprobarse el pago. * El pago contra entrega solo aplica a canales a domicilio y el pago al recoger a canales donde el cliente pasa por su pedido. * Con pago anticipado obligatorio se exige al menos un método que cobre antes de preparar; los métodos que cobran al recibir no se permiten. * Sin pago anticipado se puede quedar sin ningún método: el cliente no paga desde su celular y el cobro queda en caja. * 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
|
| 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>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"fulfillmentUuid": "string",
"channelId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"fulfillmentUuid": "23dd668c-ab4a-11f1-b72d-f2569efa6eee",
"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
}
]
}
}