Cobrar un método de pago guardado
Cobra directamente un método de pago guardado (token), sin necesidad de crear un checkout. El payment_method_id se obtiene del payload de un webhook o de un GET a un checkout pagado.
También puedes asociar el cobro a una suscripción enviando subscription_id (con amount_in_cents + description). Con mode: now se cobra de inmediato el método de pago de la suscripción; con mode: next_cycle se agrega un cobro pendiente que se cobra en el próximo cargo exitoso (admite créditos / montos negativos). La respuesta incluye un campo object (one_time_payment o invoice_item).
Si operas una plataforma, envía X-ACCOUNT-ID para cobrar bajo una cuenta conectada (modelo directo): el pago, los productos y la factura quedan bajo esa cuenta, y el método de pago o la suscripción deben pertenecerle. El payment_method_id de una cuenta conectada se obtiene del payload de sus webhooks (llegan al padre con connected: true y account_id).
Headers
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
Pago cobrado (cobro directo o mode: now)
Changes
No recorded changes to this endpoint across all 1 revision of this API.