Restofy Docs
Métodos de pago POST

Crear método de pago

POST /api/payment-methods/create-payment-method

Descripción

Da de alta un método de pago nuevo en el restaurante.

Detalles

Crea un método de pago indicando su tipo, ícono y color. El código interno se genera automáticamente a partir del nombre. La cuenta destino es obligatoria salvo para efectivo, cupón, crédito y anticipo del cliente.

Permisos requeridos

admin.module

Request

Nombre Tipo Requerido Reglas
name string
min:1 max:100
paymentMethodTypeId int
min_value:1
targetAccountId int No
min_value:1
paymentProviderId int No
min_value:1
iconFontAwesome string No
max:100
color string No
min:7 max:7
requiresReference bool
followsCashSession bool
requiresDeclaration bool
sortOrder int No
min_value:0

Ejemplo de request

curl -X POST https://restofy.pro/api/payment-methods/create-payment-method \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "name": "string",
    "paymentMethodTypeId": 1,
    "requiresReference": true,
    "followsCashSession": true,
    "requiresDeclaration": true
}'

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

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "name": "Gateway Test 6aa038f6dffb6",
    "paymentMethodTypeId": 7,
    "targetAccountId": 16,
    "paymentProviderId": 9001,
    "requiresReference": false,
    "followsCashSession": false,
    "requiresDeclaration": false
}

Response

{
    "success": true,
    "message": "Método de pago creado",
    "data": {
        "paymentMethodId": "14"
    }
}