R2 Connect API

Pagos

Cobros con su método, proveedor y momento exacto. La base de la conciliación contable.

GET/paymentsrequiere read:payments

Cada pago apunta a la orden que liquida. Un mismo importe puede llegar en varios pagos (anticipo y liquidación) y por métodos distintos.

Parámetros#

Parámetro	Tipo	Descripción
limit	integer	Resultados por página. Entre 1 y 50. Predeterminado: 25.
cursor	string	Cursor de la página siguiente, tomado de `pagination.cursor`.
created_from	date	Fecha inicial, formato `AAAA-MM-DD` (UTC) o epoch en milisegundos.
created_to	date	Fecha final, inclusiva. Mismo formato.
status	string	Filtra por estado exacto.

Campos#

Campo	Tipo	Descripción
order_id	string	Orden que liquida este pago.
order_number	string	Número visible de esa orden, para cruzarlo con tu sistema.
amount	number	Importe del pago.
currency	string	Moneda en formato ISO 4217.
status	string	Estado del pago.
method	string	`card`, `cash`, `transfer`, `loyalty_points` u `other`.
payment_type	string	`full`, `partial`, `deferred`, `cash` o `preauth`.
provider	string	Procesador que ejecutó el cobro, si fue electrónico.
external_id	string	Referencia del procesador, para conciliar contra su estado de cuenta.
succeeded_at	datetime	Momento en que el cobro se confirmó. Es la fecha contable.

Cuenta solo lo cobrado

Para sumar ingreso real usa exclusivamente los pagos con status igual a succeeded o captured. Los demás estados representan intentos, autorizaciones sin cobrar o reversos.

Ejemplo#

bash

curl -H "Authorization: Bearer TU_LLAVE" \
  "https://api.r2-os.com/api/connect/v1/payments?created_from=2026-07-01&status=succeeded"

json

{
  "data": [
    {
      "id": "n47dk3mzq81ba5tv",
      "order_id": "p97cbaneya88az5ra",
      "order_number": "ORD-MRNCRMX2-3BAW",
      "amount": 2088,
      "currency": "MXN",
      "status": "succeeded",
      "method": "card",
      "payment_type": "full",
      "provider": "stripe",
      "external_id": "pi_3Qx…",
      "created_at": "2026-07-16T10:20:11.402Z",
      "succeeded_at": "2026-07-16T10:20:14.907Z"
    }
  ],
  "pagination": { "cursor": null, "has_more": false }
}

AnteriorÓrdenes SiguienteClientes