Listado de precios - OnePay Documentación

curl "https://api.onepay.la/v1/prices?product=9f5d85a0-1111-7000-aaaa-000000000001&active=true&per_page=15&page=1" \
  -H "Authorization: Bearer sk_test_xxx"

const params = new URLSearchParams({
  product: '9f5d85a0-1111-7000-aaaa-000000000001',
  active: 'true',
  per_page: '15',
  page: '1'
});

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

const data = await response.json();
console.log(data.data); // Array de precios
console.log(data.current_page); // Página actual

import requests

response = requests.get(
    'https://api.onepay.la/v1/prices',
    params={
        'product': '9f5d85a0-1111-7000-aaaa-000000000001',
        'active': True,
        'per_page': 15,
        'page': 1
    },
    headers={
        'Authorization': 'Bearer sk_test_xxx'
    }
)

data = response.json()
print(data['data'])          # Array de precios
print(data['current_page'])  # Página actual

<?php
$curl = curl_init();

$query = http_build_query([
    "product" => "9f5d85a0-1111-7000-aaaa-000000000001",
    "active" => "true",
    "per_page" => 15,
    "page" => 1
]);

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.onepay.la/v1/prices?" . $query,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer sk_test_xxx"
    ]
]);

$data = json_decode(curl_exec($curl), true);
print_r($data["data"]);       // Array de precios
echo $data["current_page"];   // Página actual
?>

{
  "data": [
    {
      "id": "9f5d85a0-2222-7000-aaaa-000000000002",
      "object": "price",
      "product": "9f5d85a0-1111-7000-aaaa-000000000001",
      "active": true,
      "nickname": "Mensual",
      "lookup_key": "pro_monthly",
      "currency": "COP",
      "unit_amount_in_cents": 7990000,
      "type": "recurring",
      "recurring": {
        "interval": "month",
        "interval_count": 1,
        "total_cycles": null,
        "trial_period_days": 0
      },
      "created_at": "2026-07-13T12:00:00.000000Z"
    }
  ],
  "current_page": 1,
  "from": 1,
  "last_page": 1,
  "per_page": 15,
  "to": 1,
  "total": 1
}

GET

prices

curl "https://api.onepay.la/v1/prices?product=9f5d85a0-1111-7000-aaaa-000000000001&active=true&per_page=15&page=1" \
  -H "Authorization: Bearer sk_test_xxx"

const params = new URLSearchParams({
  product: '9f5d85a0-1111-7000-aaaa-000000000001',
  active: 'true',
  per_page: '15',
  page: '1'
});

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

const data = await response.json();
console.log(data.data); // Array de precios
console.log(data.current_page); // Página actual

import requests

response = requests.get(
    'https://api.onepay.la/v1/prices',
    params={
        'product': '9f5d85a0-1111-7000-aaaa-000000000001',
        'active': True,
        'per_page': 15,
        'page': 1
    },
    headers={
        'Authorization': 'Bearer sk_test_xxx'
    }
)

data = response.json()
print(data['data'])          # Array de precios
print(data['current_page'])  # Página actual

<?php
$curl = curl_init();

$query = http_build_query([
    "product" => "9f5d85a0-1111-7000-aaaa-000000000001",
    "active" => "true",
    "per_page" => 15,
    "page" => 1
]);

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.onepay.la/v1/prices?" . $query,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer sk_test_xxx"
    ]
]);

$data = json_decode(curl_exec($curl), true);
print_r($data["data"]);       // Array de precios
echo $data["current_page"];   // Página actual
?>

{
  "data": [
    {
      "id": "9f5d85a0-2222-7000-aaaa-000000000002",
      "object": "price",
      "product": "9f5d85a0-1111-7000-aaaa-000000000001",
      "active": true,
      "nickname": "Mensual",
      "lookup_key": "pro_monthly",
      "currency": "COP",
      "unit_amount_in_cents": 7990000,
      "type": "recurring",
      "recurring": {
        "interval": "month",
        "interval_count": 1,
        "total_cycles": null,
        "trial_period_days": 0
      },
      "created_at": "2026-07-13T12:00:00.000000Z"
    }
  ],
  "current_page": 1,
  "from": 1,
  "last_page": 1,
  "per_page": 15,
  "to": 1,
  "total": 1
}

Obtiene los precios registrados en tu cuenta de OnePay. Solo se devuelven los precios del catálogo (aquellos asociados a un producto), ordenados del más reciente al más antiguo, dentro de un envelope de paginación.

Query Parameters

product

string

Filtra los precios por el ID de un producto tuyo. Ver productos.

active

boolean

Filtra por estado. true devuelve solo los precios vigentes.

lookup_keys

array

Resuelve uno o varios precios por su lookup_key. Se envía como arreglo, por ejemplo ?lookup_keys[]=pro_monthly&lookup_keys[]=pro_yearly.

per_page

integer

default:"15"

Cantidad de registros por página.

page

integer

default:"1"

Número de página a consultar.

curl "https://api.onepay.la/v1/prices?product=9f5d85a0-1111-7000-aaaa-000000000001&active=true&per_page=15&page=1" \
  -H "Authorization: Bearer sk_test_xxx"

const params = new URLSearchParams({
  product: '9f5d85a0-1111-7000-aaaa-000000000001',
  active: 'true',
  per_page: '15',
  page: '1'
});

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

const data = await response.json();
console.log(data.data); // Array de precios
console.log(data.current_page); // Página actual

import requests

response = requests.get(
    'https://api.onepay.la/v1/prices',
    params={
        'product': '9f5d85a0-1111-7000-aaaa-000000000001',
        'active': True,
        'per_page': 15,
        'page': 1
    },
    headers={
        'Authorization': 'Bearer sk_test_xxx'
    }
)

data = response.json()
print(data['data'])          # Array de precios
print(data['current_page'])  # Página actual

<?php
$curl = curl_init();

$query = http_build_query([
    "product" => "9f5d85a0-1111-7000-aaaa-000000000001",
    "active" => "true",
    "per_page" => 15,
    "page" => 1
]);

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.onepay.la/v1/prices?" . $query,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer sk_test_xxx"
    ]
]);

$data = json_decode(curl_exec($curl), true);
print_r($data["data"]);       // Array de precios
echo $data["current_page"];   // Página actual
?>

Response

data

array

Colección de precios de la página actual.

Show Propiedades

string

Identificador único del precio (UUID).

object

string

Tipo de objeto, siempre price.

product

string

ID del producto padre al que pertenece el precio.

active

boolean

Indica si el precio está vigente. Un precio archivado es false.

nickname

string

Etiqueta interna del precio. Puede ser null.

lookup_key

string

Clave estable para re-apuntar el precio vigente sin cambiar tu código. Puede ser null.

currency

string

Moneda ISO del cobro (por ejemplo COP).

unit_amount_in_cents

integer

Monto a cobrar, expresado en centavos.

type

string

Tipo de precio, siempre recurring.

recurring

object

Configuración de recurrencia del cobro.

Show recurring

interval

string

Unidad del ciclo: day o month.

interval_count

integer

Número de intervalos por ciclo.

total_cycles

integer

Número total de ciclos. null cuando es indefinido.

trial_period_days

integer

Días de prueba antes del primer cobro.

created_at

string

Fecha de creación en formato ISO 8601.

current_page

integer

Página actual devuelta.

from

integer

Índice del primer registro de la página.

last_page

integer

Última página disponible.

per_page

integer

Cantidad de registros por página.

integer

Índice del último registro de la página.

total

integer

Total de precios que coinciden con el filtro.

{
  "data": [
    {
      "id": "9f5d85a0-2222-7000-aaaa-000000000002",
      "object": "price",
      "product": "9f5d85a0-1111-7000-aaaa-000000000001",
      "active": true,
      "nickname": "Mensual",
      "lookup_key": "pro_monthly",
      "currency": "COP",
      "unit_amount_in_cents": 7990000,
      "type": "recurring",
      "recurring": {
        "interval": "month",
        "interval_count": 1,
        "total_cycles": null,
        "trial_period_days": 0
      },
      "created_at": "2026-07-13T12:00:00.000000Z"
    }
  ],
  "current_page": 1,
  "from": 1,
  "last_page": 1,
  "per_page": 15,
  "to": 1,
  "total": 1
}

Introducción

Detalle del precio

​Query Parameters

​Response

Query Parameters

Response