Skip to main content
GET
/
transactions
/
{transaction_id}
Detalle de un movimiento
curl --request GET \
  --url https://api.onepay.la/v1/transactions/{transaction_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "0194b42f-5515-7245-b9f4-193c92f37b8c",
  "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",
  "node_type": "Payment",
  "node_id": "9e16627d-1eb9-46c4-ba19-b229ea77d68e",
  "node": {
    "id": "9e16627d-1eb9-46c4-ba19-b229ea77d68e",
    "source": "Pago de pedido ORD-9912",
    "currency": "COP",
    "amount": 50000,
    "amount_label": "$50.000",
    "title": "Pago de pedido ORD-9912",
    "status": "approved",
    "is_test": false,
    "external_id": "ORD-9912",
    "created_at": "2025-01-29T22:29:48.000000Z",
    "paid_at": "2025-01-29T22:29:48.000000Z",
    "payment_link": "https://checkout.onepay.la/9e16627d-1eb9-46c4-ba19-b229ea77d68e"
  }
}
Obtiene un movimiento de la billetera de tu empresa. Es un endpoint solo de consulta. A diferencia del listado, el detalle sí incluye el node: el origen del movimiento (un pago, una dispersión, etc.).

​
Path Parameters

​
transaction_id
string
required
UUID del movimiento obtenido desde el listado de movimientos.

​
Ejemplos de uso

curl https://api.onepay.la/v1/transactions/0194b42f-5515-7245-b9f4-193c92f37b8c \
  -X GET \
  -H "Authorization: Bearer sk_test_xxx"

​
Response

​
id
string
UUID del movimiento.
​
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 de valores).
​
subtype_label
string
Etiqueta legible del subtype.
​
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.
​
node_type
string
Tipo del nodo de origen del movimiento, por ejemplo Payment o CashoutLine. Es null cuando el movimiento no tiene un origen asociado.
​
node_id
string
UUID del nodo de origen. Es null cuando no aplica.
​
node
object
Objeto con el origen del movimiento. Su forma depende de node_type:
  • Payment: el pago asociado (mismo formato que el detalle de pago).
  • CashoutLine: la línea de dispersión asociada.
  • Otros tipos: null.

​
Ejemplo de respuesta

{
  "id": "0194b42f-5515-7245-b9f4-193c92f37b8c",
  "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",
  "node_type": "Payment",
  "node_id": "9e16627d-1eb9-46c4-ba19-b229ea77d68e",
  "node": {
    "id": "9e16627d-1eb9-46c4-ba19-b229ea77d68e",
    "source": "Pago de pedido ORD-9912",
    "currency": "COP",
    "amount": 50000,
    "amount_label": "$50.000",
    "title": "Pago de pedido ORD-9912",
    "status": "approved",
    "is_test": false,
    "external_id": "ORD-9912",
    "created_at": "2025-01-29T22:29:48.000000Z",
    "paid_at": "2025-01-29T22:29:48.000000Z",
    "payment_link": "https://checkout.onepay.la/9e16627d-1eb9-46c4-ba19-b229ea77d68e"
  }
}