Obtener un intent (formato unificado)
Recurso Intent unificado: devuelve el formato normalizado para cualquier tipo de pago (payment, bank_transfer, crypto, balance, cash), discriminado por el campo type.
Authentication
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.
La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).
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.
Path parameters
Response
ID del intent unificado; es la llave canónica para GET /intents/{id} y los eventos intent.*.
Estado normalizado. paid aplica solo al evento del pagador en pagos con balance (type balance).
Estado concreto sin normalizar (ej. requires_capture)
ID del mismo pago en el formato anterior de webhooks por tipo. Permite vincular registros históricos al migrar a eventos unificados; el ID canónico sigue siendo id.
Suscripción a la que pertenece el cobro: su renovación o un cobro hecho sobre ella, como el prorrateo de now_and_charge. id es null en cobros sin suscripción.
Public page for the payment’s final certified tax document (invoice, receipt, or donation receipt). Exempt accounts default to receipts; NGOs default to donation receipts and can choose receipts in invoicing settings. The page links to the certifier’s copy; tax_invoice_uuid remains the authorization number. API responses return the current value. Webhooks reflect the value available when delivered and may contain null even if certification succeeds later.
Campos específicos del tipo de pago. Para type: payment, incluye failure_reason, comisiones, cuotas, canal y productos. Para type: bank_transfer, incluye bank_reference (referencia asignada por el banco o la red de pago) y sender_comment (comentario libre del pagador).