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).
En cobros directos con payment_method_id e items, transfer_setups permite dividir el neto acreditado mediante transferencias fijas. No se acepta en la variante de cobro a una suscripción.
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.
Request
Response
Pago cobrado (cobro directo o mode: now)
Transferencias automáticas asociadas al cobro y su estado actual.