API de pagos de comercio electrónico HandyPay

API REST pública para integrar pagos HandyPay en cualquier aplicación. Autentíquese con claves API, administre productos, clientes, sesiones de pago, suscripciones y reciba notificaciones de webhooks.

URL base

https://api.handypay.me/api/v1

javascript

Versión de API: 2025-01-01 : devuelto en el X-API-Version encabezado en cada respuesta.

Inicio rápido

Póngase en funcionamiento en menos de un minuto. Obtenga una clave API, configure el cliente, realice una solicitud.

Obtenga su clave API

Genere claves desde Portal de comercios. Todas las solicitudes requieren un token de portador en Authorization encabezado.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Sandbox

hp_live_Producción

Configurar el cliente API

Crear un asistente reutilizable. Funciona en Next.js, React Native y Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Almacene su clave en .env como HANDYPAY_API_KEY. Nunca lo expongas en el lado del cliente.

Haz tu primera solicitud

Enumera tus productos para verificar que todo funciona.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

equivalente a cURL

cURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Deberías obtener una respuesta JSON con "success": true y los datos de tus productos.

límites de velocidad

1000 solicitudes por hora por clave API. Superar el límite regresa 429 con un Retry-After encabezado.

Qué puedes crear

Pagos únicos

Crea productos y sesiones de pago alojadas para compras individuales.

Suscripciones

Facturación recurrente con intervalos flexibles, pruebas y cancelación.

Multidivisa

Acepta USD, JMD, CAD y más en 10 países.

Webhooks

Evento en tiempo real notificaciones para el pago y el ciclo de vida de la suscripción.

Intervalos de facturación

Los productos de suscripción admiten los siguientes intervalos de facturación recurrentes.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Próximos pasos

Consulte la referencia completa de la API para ver los detalles de los endpoints o vaya directamente a las recetas de integración para Next.js, React Native y Express.

API de pagos de comercio electrónico HandyPay

URL base

https://api.handypay.me/api/v1

javascript

Versión de API: 2025-01-01 : devuelto en el X-API-Version encabezado en cada respuesta.

Inicio rápido

Póngase en funcionamiento en menos de un minuto. Obtenga una clave API, configure el cliente, realice una solicitud.

Obtenga su clave API

Genere claves desde Portal de comercios. Todas las solicitudes requieren un token de portador en Authorization encabezado.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Sandbox

hp_live_Producción

Configurar el cliente API

Crear un asistente reutilizable. Funciona en Next.js, React Native y Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Almacene su clave en .env como HANDYPAY_API_KEY. Nunca lo expongas en el lado del cliente.

Haz tu primera solicitud

Enumera tus productos para verificar que todo funciona.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

equivalente a cURL

cURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Deberías obtener una respuesta JSON con "success": true y los datos de tus productos.

límites de velocidad

1000 solicitudes por hora por clave API. Superar el límite regresa 429 con un Retry-After encabezado.

Qué puedes crear

Pagos únicos

Crea productos y sesiones de pago alojadas para compras individuales.

Suscripciones

Facturación recurrente con intervalos flexibles, pruebas y cancelación.

Multidivisa

Acepta USD, JMD, CAD y más en 10 países.

Webhooks

Evento en tiempo real notificaciones para el pago y el ciclo de vida de la suscripción.

Intervalos de facturación

Los productos de suscripción admiten los siguientes intervalos de facturación recurrentes.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Próximos pasos

Consulte la referencia completa de la API para ver los detalles de los endpoints o vaya directamente a las recetas de integración para Next.js, React Native y Express.

API de pagos de comercio electrónico HandyPay

URL base

https://api.handypay.me/api/v1

javascript

Versión de API: 2025-01-01 : devuelto en el X-API-Version encabezado en cada respuesta.

Inicio rápido

Póngase en funcionamiento en menos de un minuto. Obtenga una clave API, configure el cliente, realice una solicitud.

Obtenga su clave API

Genere claves desde Portal de comercios. Todas las solicitudes requieren un token de portador en Authorization encabezado.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Sandbox

hp_live_Producción

Configurar el cliente API

Crear un asistente reutilizable. Funciona en Next.js, React Native y Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Almacene su clave en .env como HANDYPAY_API_KEY. Nunca lo expongas en el lado del cliente.

Haz tu primera solicitud

Enumera tus productos para verificar que todo funciona.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

equivalente a cURL

cURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Deberías obtener una respuesta JSON con "success": true y los datos de tus productos.

límites de velocidad

1000 solicitudes por hora por clave API. Superar el límite regresa 429 con un Retry-After encabezado.

Qué puedes crear

Pagos únicos

Crea productos y sesiones de pago alojadas para compras individuales.

Suscripciones

Facturación recurrente con intervalos flexibles, pruebas y cancelación.

Multidivisa

Acepta USD, JMD, CAD y más en 10 países.

Webhooks

Evento en tiempo real notificaciones para el pago y el ciclo de vida de la suscripción.

Intervalos de facturación

Los productos de suscripción admiten los siguientes intervalos de facturación recurrentes.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Próximos pasos

Consulte la referencia completa de la API para ver los detalles de los endpoints o vaya directamente a las recetas de integración para Next.js, React Native y Express.

API de pagos de comercio electrónico HandyPay

URL base

https://api.handypay.me/api/v1

javascript

Versión de API: 2025-01-01 : devuelto en el X-API-Version encabezado en cada respuesta.

Inicio rápido

Póngase en funcionamiento en menos de un minuto. Obtenga una clave API, configure el cliente, realice una solicitud.

Obtenga su clave API

Genere claves desde Portal de comercios. Todas las solicitudes requieren un token de portador en Authorization encabezado.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Sandbox

hp_live_Producción

Configurar el cliente API

Crear un asistente reutilizable. Funciona en Next.js, React Native y Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Almacene su clave en .env como HANDYPAY_API_KEY. Nunca lo expongas en el lado del cliente.

Haz tu primera solicitud

Enumera tus productos para verificar que todo funciona.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

equivalente a cURL

cURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Deberías obtener una respuesta JSON con "success": true y los datos de tus productos.

límites de velocidad

1000 solicitudes por hora por clave API. Superar el límite regresa 429 con un Retry-After encabezado.

Qué puedes crear

Pagos únicos

Crea productos y sesiones de pago alojadas para compras individuales.

Suscripciones

Facturación recurrente con intervalos flexibles, pruebas y cancelación.

Multidivisa

Acepta USD, JMD, CAD y más en 10 países.

Webhooks

Evento en tiempo real notificaciones para el pago y el ciclo de vida de la suscripción.

Intervalos de facturación

Los productos de suscripción admiten los siguientes intervalos de facturación recurrentes.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Próximos pasos

Consulte la referencia completa de la API para ver los detalles de los endpoints o vaya directamente a las recetas de integración para Next.js, React Native y Express.

API de pagos de comercio electrónico HandyPay

URL base

https://api.handypay.me/api/v1

javascript

Versión de API: 2025-01-01 : devuelto en el X-API-Version encabezado en cada respuesta.

Inicio rápido

Póngase en funcionamiento en menos de un minuto. Obtenga una clave API, configure el cliente, realice una solicitud.

Obtenga su clave API

Genere claves desde Portal de comercios. Todas las solicitudes requieren un token de portador en Authorization encabezado.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Sandbox

hp_live_Producción

Configurar el cliente API

Crear un asistente reutilizable. Funciona en Next.js, React Native y Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Almacene su clave en .env como HANDYPAY_API_KEY. Nunca lo expongas en el lado del cliente.

Haz tu primera solicitud

Enumera tus productos para verificar que todo funciona.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

equivalente a cURL

cURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Deberías obtener una respuesta JSON con "success": true y los datos de tus productos.

límites de velocidad

1000 solicitudes por hora por clave API. Superar el límite regresa 429 con un Retry-After encabezado.

Qué puedes crear

Pagos únicos

Crea productos y sesiones de pago alojadas para compras individuales.

Suscripciones

Facturación recurrente con intervalos flexibles, pruebas y cancelación.

Multidivisa

Acepta USD, JMD, CAD y más en 10 países.

Webhooks

Evento en tiempo real notificaciones para el pago y el ciclo de vida de la suscripción.

Intervalos de facturación

Los productos de suscripción admiten los siguientes intervalos de facturación recurrentes.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Próximos pasos

Consulte la referencia completa de la API para ver los detalles de los endpoints o vaya directamente a las recetas de integración para Next.js, React Native y Express.

API de pagos de comercio electrónico HandyPay

URL base

https://api.handypay.me/api/v1

javascript

Versión de API: 2025-01-01 : devuelto en el X-API-Version encabezado en cada respuesta.

Inicio rápido

Póngase en funcionamiento en menos de un minuto. Obtenga una clave API, configure el cliente, realice una solicitud.

Obtenga su clave API

Genere claves desde Portal de comercios. Todas las solicitudes requieren un token de portador en Authorization encabezado.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Sandbox

hp_live_Producción

Configurar el cliente API

Crear un asistente reutilizable. Funciona en Next.js, React Native y Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Almacene su clave en .env como HANDYPAY_API_KEY. Nunca lo expongas en el lado del cliente.

Haz tu primera solicitud

Enumera tus productos para verificar que todo funciona.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

equivalente a cURL

cURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Deberías obtener una respuesta JSON con "success": true y los datos de tus productos.

límites de velocidad

1000 solicitudes por hora por clave API. Superar el límite regresa 429 con un Retry-After encabezado.

Qué puedes crear

Pagos únicos

Crea productos y sesiones de pago alojadas para compras individuales.

Suscripciones

Facturación recurrente con intervalos flexibles, pruebas y cancelación.

Multidivisa

Acepta USD, JMD, CAD y más en 10 países.

Webhooks

Evento en tiempo real notificaciones para el pago y el ciclo de vida de la suscripción.

Intervalos de facturación

Los productos de suscripción admiten los siguientes intervalos de facturación recurrentes.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Próximos pasos

Consulte la referencia completa de la API para ver los detalles de los endpoints o vaya directamente a las recetas de integración para Next.js, React Native y Express.

API de pagos de comercio electrónico HandyPay

URL base

https://api.handypay.me/api/v1

javascript

Versión de API: 2025-01-01 : devuelto en el X-API-Version encabezado en cada respuesta.

Inicio rápido

Póngase en funcionamiento en menos de un minuto. Obtenga una clave API, configure el cliente, realice una solicitud.

Obtenga su clave API

Genere claves desde Portal de comercios. Todas las solicitudes requieren un token de portador en Authorization encabezado.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Sandbox

hp_live_Producción

Configurar el cliente API

Crear un asistente reutilizable. Funciona en Next.js, React Native y Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Almacene su clave en .env como HANDYPAY_API_KEY. Nunca lo expongas en el lado del cliente.

Haz tu primera solicitud

Enumera tus productos para verificar que todo funciona.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

equivalente a cURL

cURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Deberías obtener una respuesta JSON con "success": true y los datos de tus productos.

límites de velocidad

1000 solicitudes por hora por clave API. Superar el límite regresa 429 con un Retry-After encabezado.

Qué puedes crear

Pagos únicos

Crea productos y sesiones de pago alojadas para compras individuales.

Suscripciones

Facturación recurrente con intervalos flexibles, pruebas y cancelación.

Multidivisa

Acepta USD, JMD, CAD y más en 10 países.

Webhooks

Evento en tiempo real notificaciones para el pago y el ciclo de vida de la suscripción.

Intervalos de facturación

Los productos de suscripción admiten los siguientes intervalos de facturación recurrentes.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Próximos pasos

Consulte la referencia completa de la API para ver los detalles de los endpoints o vaya directamente a las recetas de integración para Next.js, React Native y Express.