Detalle de un movimiento

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

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

fetch('https://api.onepay.la/v1/transactions/{transaction_id}', 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/transactions/{transaction_id}",
  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/transactions/{transaction_id}"

	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/transactions/{transaction_id}")

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

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

{
  "message": "Registro no encontrado",
  "code": 10002,
  "code_name": "record_not_found"
}

GET

transactions

{transaction_id}

Detalle de un movimiento

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

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

fetch('https://api.onepay.la/v1/transactions/{transaction_id}', 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/transactions/{transaction_id}",
  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/transactions/{transaction_id}"

	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/transactions/{transaction_id}")

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

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

{
  "message": "Registro no encontrado",
  "code": 10002,
  "code_name": "record_not_found"
}

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

string

required

UUID del movimiento obtenido desde el listado de movimientos.

Ejemplos de uso

curl
JavaScript
Python

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

const response = await fetch('https://api.onepay.la/v1/transactions/0194b42f-5515-7245-b9f4-193c92f37b8c', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_test_xxx',
  },
});
const data = await response.json();

import requests

response = requests.get(
    'https://api.onepay.la/v1/transactions/0194b42f-5515-7245-b9f4-193c92f37b8c',
    headers={'Authorization': 'Bearer sk_test_xxx'},
)
data = response.json()

Response

string

UUID del movimiento.

string

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

number

Monto del movimiento en pesos (COP).

string

Monto formateado, por ejemplo $50.000.

string

Concepto del movimiento. Puede ser null.

string

Descripción legible del movimiento. Puede ser null.

string

Código del tipo de movimiento (ver tabla de valores).

string

Etiqueta legible del subtype.

boolean

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

string

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

string

Fecha de creación en formato ISO 8601.

string

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

string

Tipo del nodo de origen del movimiento, por ejemplo Payment o CashoutLine. Es null cuando el movimiento no tiene un origen asociado.

string

UUID del nodo de origen. Es null cuando no aplica.

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

{
  "message": "Registro no encontrado",
  "code": 10002,
  "code_name": "record_not_found"
}

API

Empresas

Métodos de pago

Recaudo

Productos

Facturación

Balances

Webhooks

Fintech as a service

Detalle de un movimiento

Path Parameters

Ejemplos de uso

Response

Ejemplo de respuesta

​Path Parameters

​Ejemplos de uso

​Response

​Ejemplo de respuesta

Path Parameters

Ejemplos de uso

Response

Ejemplo de respuesta