GET
utilities
/
direct-debits
/
payments
Listado de cobros suscritos a débitos de facturas
curl --request GET \
  --url https://api.onepay.la/v1/utilities/direct-debits/payments \
  --header 'Authorization: Bearer <token>'
{
"data": [
  {
    "bill_id": "0196cf6b-71df-739f-a2c6-53c7f3757c63",
    "amount_in_cents": 100000,
    "status": "Aprobada",
    "created_at": "2025-05-14T15:30:47.000000Z",
    "updated_at": "2025-05-14T15:30:47.000000Z",
    "paid_at": "2025-05-14T15:40:47.000000Z",
    "reference": "REF123",
    "remarks": null,
    "payment_method_type": "Card",
    "payment_method_description": null,
    "paid_data": {
      "success": "00",
      "status": "paid",
      "message": "Pago aplicado con éxito.",
      "approval": "123ABC"
    }
  }
],
"current_page": 1,
"from": 1,
"last_page": 1,
"per_page": 50,
"to": 1,
"total": 1
}

Consulta los pagos asociados a un débito automático específico utilizando su bill_id.

​
filter[bill_id]
string

Filtra por el ID de la domiciliación.
Debe usarse como filter[bill_id]=...

​
filter[reference]
string

Filtra por referencia del pago.

​
filter[status]
string

Filtra por estado del pago.
Ver los estados posibles en la sección “Estados posibles del pago”.

​
filter[amount_in_cents]
string

Filtra por monto exacto en centavos.

​
filter[paid_at]
string

(ISO 8601) | Filtra por fecha de pago.

​
sort
string

Ordena los resultados por un campo.
Ejemplo: sort=paid_at o sort=-amount_in_cents.
Campos soportados: amount_in_cents, status, created_at, paid_at.

{
"data": [
  {
    "bill_id": "0196cf6b-71df-739f-a2c6-53c7f3757c63",
    "amount_in_cents": 100000,
    "status": "Aprobada",
    "created_at": "2025-05-14T15:30:47.000000Z",
    "updated_at": "2025-05-14T15:30:47.000000Z",
    "paid_at": "2025-05-14T15:40:47.000000Z",
    "reference": "REF123",
    "remarks": null,
    "payment_method_type": "Card",
    "payment_method_description": null,
    "paid_data": {
      "success": "00",
      "status": "paid",
      "message": "Pago aplicado con éxito.",
      "approval": "123ABC"
    }
  }
],
"current_page": 1,
"from": 1,
"last_page": 1,
"per_page": 50,
"to": 1,
"total": 1
}

​
📘 Campos importantes

CampoTipoDescripción
bill_idstringID de la factura.
amount_in_centsnumberMonto en centavos.
statusstringEstado actual del pago.
created_atstringFecha de creación del registro.
updated_atstringÚltima fecha de actualización del registro.
paid_atstringFecha efectiva del pago.
referencestringReferencia del pago.
remarksstringrazón de fallo.
payment_method_typestringTipo de método de pago (Card o Account).
payment_method_descriptionstring | nullDescripción del método, si aplica.
paid_data.successstringCódigo de éxito de la conciliación.
paid_data.statusstringEstado devuelto por la conciliación.
paid_data.messagestringMensaje informativo del estado de la conciliación.
paid_data.approvalstringCódigo de aprobación de la transacción en la conciliación.

​
🔄 Estados posibles del pago (status)

  • Creada
  • Pendiente
  • Pagada
  • Aprobada
  • Confirmada
  • Fallida
  • Consulta fallida

​
💳 Tipos de método de pago (payment_method_type)

  • Card
  • Account

​
🔽 Ordenamiento posible (sort)

  • amount_in_cents
  • status
  • created_at
  • paid_at