Saltar al contenido principal
GET
List Subscription Payments
Este es un endpoint completamente nuevoAntes de Plans no existía un subrecurso de pagos: el arreglo payments del objeto suscripción es un campo heredado que siempre está vacío. Como no hay una integración previa de comercios que preservar, este endpoint se lanza con una única estructura limpia data[] con el contexto completo de plan/fase, sin campos heredados.
Descuentos en los cobrosCada elemento conserva amount como el precio completo del cobro. Un cobro que tuvo una promoción también tiene discount_amount y net_amount. net_amount es amount menos discount_amount: el monto que el cliente paga por ese cobro. Es 0 para un ciclo con 100% de descuento. Ambos campos están ausentes en los cobros sin promoción. Consulta Promociones en planes de suscripción.
offset debe ser múltiplo de limitUn offset no alineado volvería a entregar filas que ya viste y corrompería has_more, por lo que se rechaza con 400 BAD_REQUEST en lugar de redondearse hacia abajo en silencio.
Los ciclos gratuitos son total: 0, no un estado distintoUn ciclo de facturación de $0 (por ejemplo, un pago de prueba gratuita) se reconoce por total == 0, no existe un estado “gratuito” separado.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido

Parámetros de ruta

subscription_id
string
requerido

El identificador único de la suscripción.

Parámetros de consulta

limit
integer
predeterminado:20

Máximo de ítems a devolver. 1-100, el valor por defecto es 20.

Rango requerido: 1 <= x <= 100
offset
integer
predeterminado:0

Número de ítems que se omitirán. Debe ser un múltiplo no negativo de limit, de lo contrario 400 BAD_REQUEST: un desplazamiento no alineado volvería a entregar filas que ya viste y corrompería has_more. El valor por defecto es 0.

Rango requerido: x >= 0

Respuesta

200

data
object[]

Cada intento de pago de esta suscripción, del más reciente al más antiguo.

pagination
object