Cobrar un método de pago guardado
Changed onCobra 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.
Request
- Base URLhttps://app.recurrente.com/api
- AuthAPI key in header X-SECRET-KEY
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Request body
Response
Pago cobrado (cobro directo o mode: now)
Changes
- breaking
added to the
response propertyoneOflist for the response status - breaking
added to the
response propertyoneOflist for the response status - breaking
added to the
response propertyoneOflist for the response status - breaking
the
/response's property type changed fromobjecttoarrayfor status - breaking
the
/response's property type changed fromobjecttoarrayfor status - breaking
the
/response's property type changed fromobjecttoarrayfor status
- breaking
- warning
deleted the
headerrequest parameterX-SECRET-KEY - info
the endpoint scheme security
secretKeywas added to the API
- warning