paymentIntents

Actualizar un payment intent

Adjunta una URL de factura fiscal a un payment intent exitoso. Solo los intents con status succeeded pueden ser actualizados.

put/payment_intents/{id}

Path parameters

idstring required

ID del payment intent

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.

Request body

Response

Payment intent actualizado

idstring

ID del payment intent

receipt_numberinteger

Número de recibo

api_versionstring

Versión de la API

live_modeboolean

true en pagos reales; false en eventos simulados de checkouts de prueba.

created_atstring date-time

Fecha de creación

customer_idstring

ID del cliente

user_idstring

ID del usuario

failure_reasonstring nullable

Razón de fallo (si aplica)

amount_in_centsinteger

Monto en centavos

currencystring

Moneda

feeinteger

Comisión cobrada

vat_withheldinteger

IVA retenido

vat_withheld_currencystring nullable

Moneda del IVA retenido

used_presaved_payment_methodboolean

Si se usó un método de pago guardado

tax_invoice_urlstring nullable

URL de la factura fiscal

channel'POS' | 'Celular como POS' | 'Link de pago'

Origen exacto del cobro con tarjeta. Usa POS para una terminal física, Celular como POS para cobros desde un teléfono y Link de pago para cobros con tarjeta en línea.

Changes

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