Saltar al contenido principal
POST
Crear plan
Los planes son inmutablesNo existe un endpoint de actualización. Un cambio de precio implica crear un plan nuevo: las suscripciones existentes se mantienen en el plan (y el precio) con el que se crearon hasta que las muevas o se cancelen. Para moverlas, usa Cambiar el plan de la suscripción (reemplazo inmediato) o el objeto plan_change en Actualizar suscripción (programado, mismo id).
Consulta la sección Códigos de respuesta HTTP para ver los detalles de los posibles resultados de error.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido

Cuerpo

application/json
name
string
requerido

El nombre del plan (MAX 255; MIN 3).

base_amount
object
requerido

El precio predeterminado que se usa para cualquier país sin una entrada explícita en country_prices.

frequency
object
requerido

La frecuencia de facturación del plan. Las suscripciones creadas a partir de este plan la heredan.

account_id
string
requerido

El account_id que encuentras en tu Dashboard de Yuno (UUID). Obligatorio: en este endpoint la cuenta se envía en el cuerpo de la solicitud, no en el encabezado X-Account-Code.

description
string

La descripción del plan. Por ahora no se aplica ningún límite de longitud.

merchant_reference
string

Tu propio identificador del plan. Por ahora no se aplica ningún límite de longitud.

country_prices
object[]

Precios explícitos opcionales por país. Un país que no aparece en la lista usa base_amount.

allowed_payment_methods
string[]

Tipos de método de pago aceptados para las suscripciones de este plan.

metadata
object[]

Pares clave-valor asociados al plan. Son independientes de cualquier metadata definido en una suscripción creada a partir de él.

phases
object[]

Escalera inicial opcional (por ejemplo, una prueba) antes del precio regular del plan. Omítela para un plan de precio fijo. La última entrada debe ser la fase REGULAR final, sin duration.

Respuesta

201

id
string
account_id
string
name
string
description
string | null
merchant_reference
string
status
string
Ejemplo:

"ACTIVE"

base_amount
object
frequency
object
country_prices
object[]
allowed_payment_methods
string[]
metadata
object[]
phases
object[]
created_at
string
updated_at
string
account_ids
string[]

IDs de cuenta.

retries
any | null

Reintentos.

retry_split
any | null

División de reintentos.

meters
any[]

Medidores.