products

Listar productos

Lista todos los productos activos de tu cuenta con paginación.

get/products

Query parameters

pageinteger

Número de página (empezando en 1)

itemsinteger

Elementos por página

Headers

X-SECRET-KEYstring required

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Response

Lista de productos

idstring

ID único del producto

statusstring

Estado del producto

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

No recorded changes to this endpoint across all 1 revision of this API.