Listar billeteras

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

[
  {
    "id": "0ced28ec-bd54-42a0-844d-00fde7b03300",
    "name": "Balance predeterminado",
    "slug": "default",
    "currency": "COP",
    "balance": 30284766.15,
    "balance_label": "$30.284.766,15",
    "is_default": true
  },
  {
    "id": "0194b42f-5515-7245-b9f4-193c92f37b8c",
    "name": "Pagos",
    "slug": "payouts",
    "currency": "COP",
    "balance": 1250000,
    "balance_label": "$1.250.000",
    "is_default": false
  }
]

GET

wallets

Listar billeteras

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

[
  {
    "id": "0ced28ec-bd54-42a0-844d-00fde7b03300",
    "name": "Balance predeterminado",
    "slug": "default",
    "currency": "COP",
    "balance": 30284766.15,
    "balance_label": "$30.284.766,15",
    "is_default": true
  },
  {
    "id": "0194b42f-5515-7245-b9f4-193c92f37b8c",
    "name": "Pagos",
    "slug": "payouts",
    "currency": "COP",
    "balance": 1250000,
    "balance_label": "$1.250.000",
    "is_default": false
  }
]

Devuelve el arreglo de billeteras (wallets) de tu empresa, cada una con su balance actual. Es un endpoint solo de consulta y no paginado.

Solo se incluyen las billeteras del entorno (live o test) que corresponde a tu token. El id de cada billetera puede usarse como filter[wallet_id] al consultar los movimientos.

Ejemplos de uso

curl
JavaScript
Python
PHP

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

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

import requests

response = requests.get(
    'https://api.onepay.la/v1/wallets',
    headers={'Authorization': 'Bearer sk_test_xxx'},
)
data = response.json()

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.onepay.la/v1/wallets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer sk_test_xxx"]
]);
$data = json_decode(curl_exec($curl), true);
?>

Response

La respuesta es un arreglo con todas las billeteras del entorno actual (no paginado).

string

UUID de la billetera. Úsalo como filter[wallet_id] al consultar movimientos.

name

string

Nombre legible de la billetera, por ejemplo Balance predeterminado.

slug

string

Identificador interno de la billetera, por ejemplo default o default_testing.

currency

string

Moneda de la billetera, por ejemplo COP.

balance

number

Balance actual en la moneda de la billetera (en pesos para COP).

balance_label

string

Balance formateado, por ejemplo $30.284.766,15.

is_default

boolean

true si es la billetera predeterminada de la empresa.

Ejemplo de respuesta

[
  {
    "id": "0ced28ec-bd54-42a0-844d-00fde7b03300",
    "name": "Balance predeterminado",
    "slug": "default",
    "currency": "COP",
    "balance": 30284766.15,
    "balance_label": "$30.284.766,15",
    "is_default": true
  },
  {
    "id": "0194b42f-5515-7245-b9f4-193c92f37b8c",
    "name": "Pagos",
    "slug": "payouts",
    "currency": "COP",
    "balance": 1250000,
    "balance_label": "$1.250.000",
    "is_default": false
  }
]

Obtener balance

Listar movimientos

​Ejemplos de uso

​Response

​Ejemplo de respuesta

Ejemplos de uso

Response

Ejemplo de respuesta