products

Crear un producto

Changed on

Crea un nuevo producto. Puede ser de pago único o de suscripción. Cada producto puede tener máximo 1 precio.

post/products

Request

Request body

Response

Producto creado exitosamente

idstring

ID único del producto

statusstring

Estado del producto

tax_category'good' | 'service'

Clasificación para FEL: good (bien) o service (servicio). Cada ítem conserva su clasificación en facturas mixtas.

namestring

Nombre del producto

descriptionstring nullable

Descripción del producto

success_urlstring nullable

URL de redirección después de un pago exitoso

cancel_urlstring nullable

URL de redirección cuando el comprador cancela

custom_terms_and_conditionsstring nullable

Términos y condiciones personalizados

phone_requirement'none' | 'optional' | 'required'

Requerimiento de teléfono

address_requirement'none' | 'optional' | 'required'

Requerimiento de dirección

billing_info_requirement'none' | 'optional' | 'required'

Requerimiento de información fiscal

has_dynamic_pricingboolean

Si usa precio dinámico

payment_method_typesProductPaymentMethodTypesItems[]

Métodos de pago habilitados para este producto, ya resueltos (cuando el producto hereda la configuración de la cuenta, refleja los métodos de la cuenta): card (tarjeta, pago de contado), bank_transfer (transferencia bancaria), stablecoins (dólares digitales), balance (Balance Recurrente). Las cuotas se exponen por separado en available_installments.

available_installmentsinteger[]

Opciones de cuotas (en meses) que se mostrarán en el checkout, independientes de payment_method_types. Vacío si no se ofrecen cuotas. Solo aplica a GTQ.

storefront_linkstring

Link público del producto en la tienda

metadataobject nullable

Metadata personalizada

Changes

    • breaking

      added to the response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to array for status

    • info

      added the new optional request property /

    • info

      added the optional property to the response with the status

    • warning

      deleted the header request parameter X-SECRET-KEY

    • info

      the endpoint scheme security secretKey was added to the API