API · Editar plan recurrente

API v1
POST /api/v1/editPlanRepeat

Qué hace#

Edita un plan existente, incluido su estado.

Autenticación#

Requiere el token bearer del API en el header Authorization — ver autenticación.

Parámetros#

keystringrequerido#

Key de la integración Tilopay.

idintegerrequerido#

Id del plan recurrente.

titlestringrequerido#

Título del plan recurrente.

descriptionstring#

Descripción del plan.

frecuencyinteger#

Frecuencia de cobro.

CódigoValor
1Diario
2Semanal
3Mensual
4Anual
5Quincenal
6Bimestral
7Trimestral
8Cuatrimestral
9Semestral
currencystringrequerido#

Código de moneda en formato ISO 4217.

first_amountintegerrequerido#

Monto por pago inicial.

trialintegerrequerido#

Activa el periodo de prueba gratis: 0 no, 1 sí.

trial_daysintegerrequerido#

Días del periodo de prueba gratis.

attemptsintegerrequerido#

Cantidad de reintentos para cobros fallidos.

statusintegerrequerido#

Estado del plan recurrente.

CódigoValor
0Inactivo
1Activo
2Activo pero sin registros nuevos
thanks_urlstring#

Campo opcional. URL de agradecimiento propia del comercio; debe soportar el método GET.

webhook_subscribestring#

Campo opcional. URL del webhook, por método POST, que recibe el callback en el cuerpo de la solicitud cuando un cliente adquiere una suscripción de forma exitosa. Ejemplo de los datos enviados: {'id_plan' : 1, 'email' : 'email@email.com', 'modality' : 'ModalityName', 'amount' : 25, 'frequency' : '', 'coupon' : '5HT5W8YT', 'free_trial' : 1, 'next_payment_date' : '2023-02-25'}

webhook_paymentstring#

Campo opcional. URL del webhook, por método POST, que recibe el callback en el cuerpo de la solicitud cuando el cargo al cliente se realiza con éxito. Ejemplo de los datos enviados: {'id_plan' : 1, 'email' : 'email@email.com', 'amount' : 25, 'auth' : '123456', 'orderNumber' : 'PRE123456'}

webhook_rejectedstring#

Campo opcional. URL del webhook, por método POST, que recibe el callback en el cuerpo de la solicitud cuando un pago falla. Ejemplo de los datos enviados: {'id_plan' : 1, 'email' : 'email@email.com', 'amount' : 25}

webhook_unsubscribestring#

Campo opcional. URL del webhook, por método POST, que recibe el callback en el cuerpo de la solicitud cuando un cliente cancela la suscripción a uno de sus planes. Ejemplo de los datos enviados: {'id_plan' : 1, 'email' : 'email@email.com', 'expire' : '2023-02-25'}

webhook_reactivestring#

Campo opcional. URL del webhook, por método POST, que recibe el callback en el cuerpo de la solicitud cuando un cliente reactiva la suscripción a uno de sus planes. Ejemplo de los datos enviados: {'id_plan' : 1, 'email' : 'email@email.com', 'next_payment_date' : '2023-02-25'}

end_atstring#

Fecha de finalización del plan recurrente, formato d-m-Y (por ejemplo 25-09-2022). Si el plan no tiene fecha de fin, se envía vacío.

Ejemplo de request#

Los valores <...> son marcadores: reemplazalos por tus credenciales y datos.

{
  "key": "<api_key>",
  "id": 3,
  "title": "Plan title",
  "description": "Plan description",
  "frecuency": 2,
  "currency": "USD",
  "first_amount": 0,
  "trial": 0,
  "trial_days": 0,
  "attempts": 5,
  "status": 1,
  "thanks_url": "",
  "webhook_subscribe": "",
  "webhook_payment": "",
  "webhook_rejected": "",
  "webhook_unsubscribe": "",
  "webhook_reactive": "",
  "end_at": "25-10-2023"
}

Para interpretar una respuesta que no es de éxito, ver cómo leer una respuesta de error.

Última verificación: 2026-08-29 · Responsable: equipo-integraciones

Ver como Markdown crudo