Restofy Docs

Métodos de pago disponibles para la orden

POST /api/pos-payment/get-order-payment-methods

Descripción

Devuelve los métodos de pago habilitados para cobrar la orden según su canal y tipo de fulfillment.

Detalles

Retorna los métodos de pago que pueden usarse para cobrar la orden, filtrados por la combinación de canal y fulfillment configurada para ese canal. Incluye también el estado actual de la orden para indicar si todavía se puede cobrar. Falla si la orden no existe.

Permisos requeridos

cash.module

Request

Nombre Tipo Requerido Reglas
orderUuid string

Ejemplo de request

curl -X POST https://app.restofy.co/api/pos-payment/get-order-payment-methods \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "orderUuid": "string"
}'

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

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "orderUuid": "fe1fab65-3981-4f18-9b4e-12ae11cc0558"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "paymentMethods": [
            {
                "methodId": 1,
                "code": "pay.cash",
                "name": "Efectivo",
                "iconFontAwesome": "fa-solid fa-money-bill-wave",
                "color": "#22c55e",
                "paymentMethodTypeId": 1,
                "paymentMethodTypeCode": "cash",
                "targetAccountId": null,
                "followsCashSession": 1,
                "requiresReference": 0,
                "sortOrder": 1
            },
            {
                "methodId": 2,
                "code": "pay.giftcard",
                "name": "Gift Card",
                "iconFontAwesome": "fa-solid fa-gift",
                "color": "#eab308",
                "paymentMethodTypeId": 5,
                "paymentMethodTypeCode": "coupon",
                "targetAccountId": null,
                "followsCashSession": 0,
                "requiresReference": 1,
                "sortOrder": 2
            },
            {
                "methodId": 3,
                "code": "pay.advance",
                "name": "Anticipo de cliente",
                "iconFontAwesome": "fa-solid fa-sack-dollar",
                "color": "#84cc16",
                "paymentMethodTypeId": 6,
                "paymentMethodTypeCode": "customer.advance",
                "targetAccountId": null,
                "followsCashSession": 0,
                "requiresReference": 0,
                "sortOrder": 3
            },
            {
                "methodId": 12,
                "code": "pay.favor-balance",
                "name": "Saldo a favor de cliente",
                "iconFontAwesome": "fa-solid fa-piggy-bank",
                "color": "#8b5cf6",
                "paymentMethodTypeId": 10,
                "paymentMethodTypeCode": "favor.balance",
                "targetAccountId": null,
                "followsCashSession": 0,
                "requiresReference": 0,
                "sortOrder": 12
            },
            {
                "methodId": 11,
                "code": null,
                "name": "Transferencia Bancaria",
                "iconFontAwesome": "fa-solid fa-building-columns",
                "color": "#0ea5e9",
                "paymentMethodTypeId": 4,
                "paymentMethodTypeCode": "bank.transfer",
                "targetAccountId": 25,
                "followsCashSession": 0,
                "requiresReference": 1,
                "sortOrder": 13
            }
        ],
        "orderLifecycleStatus": "open",
        "paymentStatus": "unpaid"
    }
}