Productos y suscripciones

Esta página cubre Productos, Precios, Planes y Suscripciones. Además de lo que se lista acá, cualquiera de estos endpoints puede devolver los errores comunes. Los que tienen un ID en la ruta también responden 404 record_not_found si el ID no es un UUID, y 404 environment_key_mismatch si el recurso es del otro ambiente. Endpoints: Productos · Precios · Planes · Suscripciones

Productos

Listar productos

GET /products · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
Sin código	500	Server Error	Un valor de `ids[]`, `starting_after` o `ending_before` no es un UUID.	Envía solo UUIDs; como cursor usa el `id` de un producto de la página anterior.	Sí, tras corregir

Detalle, actualizar y eliminar un producto

GET /products/{id} · Referencia
PUT /products/{id} · Referencia
DELETE /products/{id} · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
`10002` `record_not_found`	404	Registro no encontrado, SubscriptionProduct no existe	El producto no existe, se eliminó o es de otra empresa.	Revisa el `id`.	No
`10001` `validation_error`	422	El campo nombre es obligatorio.	Al actualizar: falta `name` (el cuerpo se valida completo) o un campo no cumple las reglas de creación.	Revisa `errors` y envía el cuerpo completo.	Sí, tras corregir

Crear un producto

POST /products · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
`10001` `validation_error`	422	El campo nombre es obligatorio.	Falta `name`, `tax_rate` está fuera de 0 a 100, hay más de 15 `marketing_features` o más de 8 `images`, o una URL no es válida.	Revisa `errors` y corrige el cuerpo.	Sí, tras corregir

Precios

Listar precios

GET /prices · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
Sin código	500	Server Error	`product`, `starting_after` o `ending_before` no es un UUID.	Envía el UUID del producto; como cursor usa el `id` de un precio de la página anterior.	Sí, tras corregir

Detalle y eliminar un precio

GET /prices/{id} · Referencia
DELETE /prices/{id} · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
`10002` `record_not_found`	404	Registro no encontrado, Plan no existe	El precio no existe, se eliminó o es de otra empresa.	Revisa el `id`.	No
`10002` `record_not_found`	404	Registro no encontrado	El `id` es de un plan creado antes de que existieran los productos.	Consúltalo o elimínalo como plan.	No

Crear un precio

POST /prices · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
`10001` `validation_error`	422	El campo product es obligatorio.	Falta `product` o `currency`; `product` no existe; `currency` no es COP, USD ni MXN; enviaste `unit_amount` y `unit_amount_in_cents` juntos o ninguno; el monto está por debajo del mínimo o por encima de tu límite; o `recurring` no es válido.	Revisa `errors` y corrige el cuerpo.	Sí, tras corregir
`10002` `record_not_found`	404	Registro no encontrado, SubscriptionProduct no existe	El producto es de otra empresa o se eliminó.	Usa un producto tuyo.	No
Sin código	500	Server Error	El producto es del otro ambiente.	Crea el precio con la llave del ambiente del producto.	Sí, tras corregir
Sin código	500	Server Error	`lookup_key` ya lo usa otro precio tuyo en este ambiente (incluso uno archivado).	Envía `transfer_lookup_key: true` o usa otro `lookup_key`.	Sí, tras corregir

Planes

Listar planes

GET /plans · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
Sin código	500	Server Error	`created_from` no es una fecha válida.	Envía la fecha como `AAAA-MM-DD`.	Sí, tras corregir

Crear un plan

POST /plans · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
`10001` `validation_error`	422	El campo nombre es obligatorio.	Falta `name`, `currency`, `amount_in_cents`, `reference_price_in_cents` o `cicle_frequency`; `coupon_id` no existe; o no se cumplen las reglas de prueba gratis, medios de pago o funcionalidades.	Revisa `errors` y corrige el cuerpo.	Sí, tras corregir
`10001` `validation_error`	422	El monto mínimo es COP $1.000	`amount_in_cents` está por debajo del mínimo de la moneda o por encima de tu límite por transacción.	Ajusta el monto.	Sí, tras corregir
Sin código	500	Server Error	`coupon_id` existe pero no se puede aplicar: inactivo, vencido, agotado, con un mínimo mayor al monto o de otra empresa.	Usa un cupón activo y vigente de tu empresa.	Sí, tras corregir

Eliminar un plan

DELETE /plans/{plan_id} · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
`10002` `record_not_found`	404	Registro no encontrado, Plan no existe	El plan no existe, ya se eliminó o es de otra empresa.	Revisa el `plan_id`.	No

Suscripciones

Listar suscripciones

GET /subscriptions · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
Sin código	500	Server Error	`created_from` o `created_to` no es una fecha válida.	Envía las fechas como `AAAA-MM-DD`.	Sí, tras corregir

Crear una suscripción

POST /subscriptions · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
`10001` `validation_error`	422	El plan id seleccionado es inválido.	Falta `plan_id` (o `price_id`), `customer_id`, `payment_method_type` o `payment_method_id`; el plan o el cliente no existen, son de otra empresa o del otro ambiente; o `payment_method_type` no es `Card` ni `Account`.	Revisa `errors` y corrige el cuerpo.	Sí, tras corregir
`10002` `record_not_found`	404	Registro no encontrado, CreditCard no existe	La tarjeta no existe, es de otro cliente o del otro ambiente. Con `Account` el mensaje es «Registro no encontrado, Cuenta no existe».	Usa un medio de pago del mismo cliente y ambiente.	No
Sin código	500	Server Error	`start_date` o `start_trial_date` no viene exactamente como `AAAA-MM-DD`.	Envía las fechas como `AAAA-MM-DD`, sin hora.	Sí, tras corregir
Sin código	500	Server Error	El precio es de pago único, no recurrente.	Suscribe solo precios recurrentes.	No
Sin código	500	Server Error	`trial_days` llegó como `null`.	Omite `trial_days` o envía un número entero.	Sí, tras corregir

Eliminar una suscripción

DELETE /subscriptions/{subscription_id} · Referencia

Código	HTTP	Mensaje	Causa probable	Qué hacer	¿Reintentar?
`10002` `record_not_found`	404	Registro no encontrado, Subscription no existe	La suscripción no existe, ya se eliminó o es de otra empresa.	Revisa el `subscription_id`.	No

API

Empresas

Métodos de pago

Recaudo

Productos

Facturación

Balances

Webhooks

Fintech as a service

Productos

Listar productos

Detalle, actualizar y eliminar un producto

Crear un producto

Precios

Listar precios

Detalle y eliminar un precio

Crear un precio

Planes

Listar planes

Crear un plan

Eliminar un plan

Suscripciones

Listar suscripciones

Crear una suscripción

Eliminar una suscripción

​Productos

​Listar productos

​Detalle, actualizar y eliminar un producto

​Crear un producto

​Precios

​Listar precios

​Detalle y eliminar un precio

​Crear un precio

​Planes

​Listar planes

​Crear un plan

​Eliminar un plan

​Suscripciones

​Listar suscripciones

​Crear una suscripción

​Eliminar una suscripción

Productos

Listar productos

Detalle, actualizar y eliminar un producto

Crear un producto

Precios

Listar precios

Detalle y eliminar un precio

Crear un precio

Planes

Listar planes

Crear un plan

Eliminar un plan

Suscripciones

Listar suscripciones

Crear una suscripción

Eliminar una suscripción