---
title: "Crear un plan de lealtad | Documentación de Ordering.co"
description: "Usa POST /loyalty_plans para crear un plan de lealtad. La operación descrita aquí es LoyaltyPlan.register."
canonical: https://docs.ordering.co/es/api-reference/guides/create-loyalty-plan/
---

# Crear un plan de lealtad

> **API operation:** [Open the endpoint in Scalar](https://docs.ordering.co/es/api-reference/#tag/loyalty_plans/POST/loyalty_plans)

Usa `POST /loyalty_plans` para crear un plan de lealtad. La operación descrita aquí es `LoyaltyPlan.register`.

El esquema documentado requiere autenticación de administrador y actualmente exige `name`, `type`, `redemption_rate`, `accumulation_rate` y `businesses`.

Consulta [Modelo de plan de lealtad](https://docs.ordering.co/es/api-reference/guides/loyalty-level-model/) y [Modelo de planes de lealtad por negocio](https://docs.ordering.co/es/api-reference/guides/business-loyalty-plans-model/).

## Referencia de OpenAPI

**Operación:** `POST /loyalty_plans`

**Campos del cuerpo de la solicitud**

| Nombre                    | Tipo            | Obligatorio |
| ------------------------- | --------------- | ----------- |
| `accumulation_rate`       | number          | Sí          |
| `businesses`              | array\<any>     | Sí          |
| `expire_after_minutes`    | integer \| null | No          |
| `maximum_accumulation`    | number \| null  | No          |
| `maximum_redemption_rate` | number          | No          |
| `maximum_redemption_type` | integer \| null | No          |
| `name`                    | any             | Sí          |
| `redemption_rate`         | number          | Sí          |
| `type`                    | string          | Sí          |

**Respuestas**

| Código | Descripción                                                                                                                                                                                                                                                                        |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200    | Envelope de éxito. `result` es la instancia serializada de LoyaltyPlan ($fillable menos $hidden).                                                                                                                                                                                  |
| 400    | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código.                                                                                                                                                                                     |
| 401    | Respuesta de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error: el proyecto no existe o no tiene una suscripción activa.                                                                                                             |
| 404    | Respuesta vacía: la versión de API solicitada no está admitida.                                                                                                                                                                                                                    |
| 429    | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key.                                                                                                                       |
| 500    | Respuesta de error: falló la búsqueda o inicialización del proyecto.                                                                                                                                                                                                               |
| 503    | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on\_error = closed (cabecera Retry-After: 1). |

[Abrir esta operación en la Referencia de la API](https://docs.ordering.co/es/api-reference/#tag/loyalty_plans/POST/loyalty_plans)