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>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.onepay.la/v1/utilities/direct-debits/payments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.onepay.la/v1/utilities/direct-debits/payments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.onepay.la/v1/utilities/direct-debits/payments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.onepay.la/v1/utilities/direct-debits/payments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
"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
}

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>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.onepay.la/v1/utilities/direct-debits/payments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.onepay.la/v1/utilities/direct-debits/payments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.onepay.la/v1/utilities/direct-debits/payments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.onepay.la/v1/utilities/direct-debits/payments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
"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.

También disponible vía QUERY. Los mismos filtros van en el cuerpo JSON en lugar de la URL, usando el método QUERY. Ver la guía del método QUERY para ejemplos. El GET sigue funcionando igual.

string

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

string

Filtra por referencia del pago.

string

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

string

Devuelve los pagos cuyo monto sea mayor o igual al valor indicado, en centavos. No es una coincidencia exacta: es un mínimo.

string

(ISO 8601) | Filtra por fecha de pago.

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

Campo	Tipo	Descripción
`bill_id`	`string`	ID de la factura.
`amount_in_cents`	`number`	Monto en centavos.
`status`	`string`	Estado actual del pago.
`created_at`	`string`	Fecha de creación del registro.
`updated_at`	`string`	Última fecha de actualización del registro.
`paid_at`	`string`	Fecha efectiva del pago.
`reference`	`string`	Referencia del pago.
`remarks`	`string`	razón de fallo.
`payment_method_type`	`string`	Tipo de método de pago (`Card` o `Account`).
`payment_method_description`	`string \| null`	Descripción del método, si aplica.
`paid_data.success`	`string`	Código de éxito de la conciliación.
`paid_data.status`	`string`	Estado devuelto por la conciliación.
`paid_data.message`	`string`	Mensaje informativo del estado de la conciliación.
`paid_data.approval`	`string`	Có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

API

Empresas

Métodos de pago

Recaudo

Productos

Facturación

Balances

Webhooks

Fintech as a service

Listado de cobros suscritos a débitos de facturas

📘 Campos importantes

🔄 Estados posibles del pago (`status`)

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

🔽 Ordenamiento posible (`sort`)

​📘 Campos importantes

​🔄 Estados posibles del pago (status)

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

​🔽 Ordenamiento posible (sort)

📘 Campos importantes

🔄 Estados posibles del pago (`status`)

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

🔽 Ordenamiento posible (`sort`)