oneTimePayments

Cobrar un método de pago guardado

Changed on

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.

post/one_time_payments

Request

Request body

OR

Response

Pago cobrado (cobro directo o mode: now)

objectstring
idstring

ID del pago

statusstring

Estado del pago

Changes

    • breaking

      added to the response property oneOf list for the response status

    • breaking

      added to the response property oneOf list for the response status

    • breaking

      added to the response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to array for status

    • breaking

      the / response's property type changed from object to array for status

    • breaking

      the / response's property type changed from object to array for status

    • warning

      deleted the header request parameter X-SECRET-KEY

    • info

      the endpoint scheme security secretKey was added to the API