Cobrar un método de pago guardado
Cobrar un método de pago guardado
Authentication
Request
Response
Pago cobrado (cobro directo o mode: now)
Cobrar un método de pago guardado
Pago cobrado (cobro directo o mode: now)
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).
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.