Skip to main content
POST
Crea un precio (price) asociado a un producto existente. El precio define cuánto y cada cuánto se cobra.
Los precios son inmutables: una vez creados no puedes cambiar el monto, la moneda ni la recurrencia. Para cambiar de precio, crea uno nuevo y archiva el anterior con Archivar precio. Usa lookup_key junto con transfer_lookup_key para mover la clave estable al precio de reemplazo sin tocar tu código.

Headers

string
required
Token único para garantizar la idempotencia de la petición

Body

string
required
ID de un producto tuyo al que pertenecerá el precio.
string
required
Moneda ISO del cobro. Máximo 3 caracteres.
integer
required
Monto a cobrar, expresado en centavos. Respeta el mínimo por moneda.
object
required
Configuración de recurrencia del cobro.
string
Etiqueta interna del precio. Máximo 100 caracteres.
string
Clave estable para re-apuntar el precio vigente sin cambiar tu código. Máximo 100 caracteres.
boolean
default:"false"
Si el lookup_key ya existe en otro precio, lo transfiere de forma atómica a este nuevo precio.
boolean
default:"false"
Marca este precio como el precio por defecto de su producto.

Response

string
Identificador único del precio (UUID).
string
Tipo de objeto, siempre price.
string
ID del producto padre al que pertenece el precio.
boolean
Indica si el precio está vigente. Un precio archivado es false.
string
Etiqueta interna del precio. Puede ser null.
string
Clave estable para re-apuntar el precio vigente. Puede ser null.
string
Moneda ISO del cobro (por ejemplo COP).
integer
Monto a cobrar, expresado en centavos.
string
Tipo de precio, siempre recurring.
object
Configuración de recurrencia del cobro.
string
Fecha de creación en formato ISO 8601.