Listar movimientos

curl --request GET \
  --url https://api.onepay.la/v1/transactions \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "0194b42f-5515-7245-b9f4-193c92f37b8c",
      "wallet_id": "0ced28ec-bd54-42a0-844d-00fde7b03300",
      "type": "deposit",
      "amount": 50000,
      "amount_label": "$50.000",
      "concept": "Pago recibido",
      "description": "Pago recibido: f37b8c",
      "subtype": "PAYIN",
      "subtype_label": "Pago",
      "confirmed": true,
      "accredited_at": null,
      "created_at": "2025-01-29T22:29:48.000000Z",
      "external_id": "ORD-9912"
    },
    {
      "id": "0194ad6d-2464-7215-a9a6-8e88d9a5a09d",
      "wallet_id": "0ced28ec-bd54-42a0-844d-00fde7b03300",
      "type": "withdraw",
      "amount": 1000,
      "amount_label": "$1.000",
      "concept": "Transferencia enviada",
      "description": "Transferencia enviada: a5a09d",
      "subtype": "CASHOUT",
      "subtype_label": "Desembolso a cuenta",
      "confirmed": true,
      "accredited_at": null,
      "created_at": "2025-01-28T14:59:58.000000Z",
      "external_id": null
    }
  ],
  "current_page": 1,
  "from": 1,
  "last_page": 65,
  "per_page": 20,
  "to": 20,
  "total": 1291
}

GET

transactions

Listar movimientos

curl --request GET \
  --url https://api.onepay.la/v1/transactions \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "0194b42f-5515-7245-b9f4-193c92f37b8c",
      "wallet_id": "0ced28ec-bd54-42a0-844d-00fde7b03300",
      "type": "deposit",
      "amount": 50000,
      "amount_label": "$50.000",
      "concept": "Pago recibido",
      "description": "Pago recibido: f37b8c",
      "subtype": "PAYIN",
      "subtype_label": "Pago",
      "confirmed": true,
      "accredited_at": null,
      "created_at": "2025-01-29T22:29:48.000000Z",
      "external_id": "ORD-9912"
    },
    {
      "id": "0194ad6d-2464-7215-a9a6-8e88d9a5a09d",
      "wallet_id": "0ced28ec-bd54-42a0-844d-00fde7b03300",
      "type": "withdraw",
      "amount": 1000,
      "amount_label": "$1.000",
      "concept": "Transferencia enviada",
      "description": "Transferencia enviada: a5a09d",
      "subtype": "CASHOUT",
      "subtype_label": "Desembolso a cuenta",
      "confirmed": true,
      "accredited_at": null,
      "created_at": "2025-01-28T14:59:58.000000Z",
      "external_id": null
    }
  ],
  "current_page": 1,
  "from": 1,
  "last_page": 65,
  "per_page": 20,
  "to": 20,
  "total": 1291
}

Devuelve la lista paginada de los movimientos de la billetera de tu empresa, ordenados del más reciente al más antiguo. Es un endpoint solo de consulta.

El listado no incluye el nodo de origen (node) de cada movimiento. Para obtenerlo, consulta el detalle de un movimiento.

Query Parameters

filter[type]

string

Filtra por tipo de movimiento: deposit (entrada de dinero) o withdraw (salida de dinero).

filter[subtype]

string

Filtra por el código de movimiento específico (ver tabla de subtype más abajo), por ejemplo PAYIN, CASHOUT o PAYOUT.

filter[confirmed]

boolean

Filtra por estado de confirmación: true (confirmados) o false (reservados / pendientes).

filter[wallet_id]

string

Filtra los movimientos de una billetera específica. El valor es el id (UUID) de la billetera, obtenido en listar billeteras. Un id inexistente o de otra empresa devuelve una lista vacía.

filter[from]

string

Fecha inicial (inclusive) en formato YYYY-MM-DD. Devuelve movimientos creados desde esta fecha.

filter[to]

string

Fecha final (inclusive) en formato YYYY-MM-DD. Devuelve movimientos creados hasta esta fecha.

sort

string

default:"-created_at"

Ordenamiento. Valores permitidos: created_at, -created_at, amount, -amount. El prefijo - indica orden descendente.

per_page

integer

default:"20"

Cantidad de resultados por página (mínimo 1, máximo 100).

page

integer

default:"1"

Número de página para paginación.

Ejemplos de uso

curl
JavaScript
Python

curl https://api.onepay.la/v1/transactions \
  -X GET \
  -H "Authorization: Bearer sk_test_xxx"

Con filtros de tipo y rango de fechas:

curl "https://api.onepay.la/v1/transactions?filter[type]=deposit&filter[from]=2025-01-01&filter[to]=2025-01-31" \
  -X GET \
  -H "Authorization: Bearer sk_test_xxx"

const params = new URLSearchParams({
  'filter[type]': 'deposit',
  'filter[from]': '2025-01-01',
  'filter[to]': '2025-01-31',
});

const response = await fetch(`https://api.onepay.la/v1/transactions?${params}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_test_xxx',
  },
});
const data = await response.json();

import requests

response = requests.get(
    'https://api.onepay.la/v1/transactions',
    params={
        'filter[type]': 'deposit',
        'filter[from]': '2025-01-01',
        'filter[to]': '2025-01-31',
    },
    headers={'Authorization': 'Bearer sk_test_xxx'},
)
data = response.json()

Response

data

array

Lista de movimientos.

Show Propiedades de cada movimiento

string

UUID del movimiento. Úsalo para consultar el detalle.

wallet_id

string

UUID de la billetera a la que pertenece el movimiento. Coincide con el id de listar billeteras.

type

string

Tipo de movimiento: deposit (entrada) o withdraw (salida).

amount

number

Monto del movimiento en pesos (COP).

amount_label

string

Monto formateado, por ejemplo $50.000.

concept

string

Concepto del movimiento. Puede ser null.

description

string

Descripción legible del movimiento. Puede ser null.

subtype

string

Código del tipo de movimiento (ver tabla más abajo).

subtype_label

string

Etiqueta legible del subtype, por ejemplo Pago.

confirmed

boolean

true si el movimiento está confirmado; false si está reservado o pendiente.

accredited_at

string

Fecha (ISO 8601) en que el saldo se acredita al balance. Puede ser null.

created_at

string

Fecha de creación en formato ISO 8601.

external_id

string

Identificador externo asociado al movimiento, si existe. Puede ser null.

current_page

integer

Página actual.

from

integer

Índice del primer registro en la página actual.

last_page

integer

Última página disponible.

per_page

integer

Cantidad de registros por página.

integer

Índice del último registro en la página actual.

total

integer

Total de movimientos.

Valores de `subtype`

Los más comunes, agrupados por categoría:

Categoría	Código	Etiqueta
Entradas	`PAYIN`	Pago
Entradas	`PAYIN_KEY`	Pago con llave
Entradas	`PAYIN_INSTANT`	Pago instantáneo
Entradas	`MONETIZATION`	Abono por monetización
Salidas	`CASHOUT`	Desembolso a cuenta
Salidas	`PAYOUT`	Transferencia
Salidas	`BILL_PAYMENT`	Pago de factura
Salidas	`WALLET_TRANSFER`	Transferencia entre Wallets OnePay
Comisiones	`PAYIN_COMMISSION`	Comisión pago aprobado con IVA
Comisiones	`PAYOUT_COMMISSION`	Procesamiento de datos transferencia con IVA
Impuestos	`TAX_ICA`	Impuesto ICA
Impuestos	`TAX_RETE_FUENTE`	Impuesto Retención en la Fuente
Impuestos	`TAX_RETE_IVA`	Impuesto Retención IVA
Ajustes	`MANUAL`	Ajuste manual de balance

Ejemplo de respuesta

{
  "data": [
    {
      "id": "0194b42f-5515-7245-b9f4-193c92f37b8c",
      "wallet_id": "0ced28ec-bd54-42a0-844d-00fde7b03300",
      "type": "deposit",
      "amount": 50000,
      "amount_label": "$50.000",
      "concept": "Pago recibido",
      "description": "Pago recibido: f37b8c",
      "subtype": "PAYIN",
      "subtype_label": "Pago",
      "confirmed": true,
      "accredited_at": null,
      "created_at": "2025-01-29T22:29:48.000000Z",
      "external_id": "ORD-9912"
    },
    {
      "id": "0194ad6d-2464-7215-a9a6-8e88d9a5a09d",
      "wallet_id": "0ced28ec-bd54-42a0-844d-00fde7b03300",
      "type": "withdraw",
      "amount": 1000,
      "amount_label": "$1.000",
      "concept": "Transferencia enviada",
      "description": "Transferencia enviada: a5a09d",
      "subtype": "CASHOUT",
      "subtype_label": "Desembolso a cuenta",
      "confirmed": true,
      "accredited_at": null,
      "created_at": "2025-01-28T14:59:58.000000Z",
      "external_id": null
    }
  ],
  "current_page": 1,
  "from": 1,
  "last_page": 65,
  "per_page": 20,
  "to": 20,
  "total": 1291
}

Listar billeteras

Detalle de un movimiento

​Query Parameters

​Ejemplos de uso

​Response

​Valores de subtype

​Ejemplo de respuesta

Query Parameters

Ejemplos de uso

Response

Valores de `subtype`

Ejemplo de respuesta