Ir al contenido
ArionPay

Base de conocimiento · 5 min de lectura

REST API: crear una factura

Crea facturas desde tu servidor con una solicitud firmada con HMAC y envía al cliente a la página de pago.

REST API: crear una factura

Autenticación

Cada solicitud lleva tres encabezados:

  • x-api-key: la clave pública de tu tienda (empieza por pk_).
  • x-timestamp: la hora Unix actual en segundos. No puede diferir más de 5 minutos de nuestro reloj.
  • x-signature: el HMAC-SHA256 en hexadecimal de timestamp.body, firmado con el secreto de API de tu tienda.

Envía también Content-Type: application/json. Cada solicitud firmada se acepta una sola vez, así que espera al menos un segundo antes de volver a enviar la misma solicitud, y fírmala de nuevo. Para mostrar el secreto de API en el panel hace falta el inicio de sesión en dos pasos con una app de autenticación.

Crear una factura

Envía POST /api/v1/invoices con amount y currency. Entre los campos opcionales están orderId, allowedAssets, expiresMin (de 5 a 1440), successUrl, cancelUrl y metadata. La respuesta contiene invoice_url: envía allí a tu cliente.

Indica test: true para crear una factura de prueba que no se puede pagar con dinero real. La referencia completa está en la documentación de la API.

// Node.js 18+
const crypto = require('crypto');

async function createInvoice() {
  const body = JSON.stringify({
amount: '49.00',
currency: 'USD',
orderId: 'ORD-1042',
allowedAssets: ['USDT_TRC20', 'BTC'],
successUrl: 'https://northwind-coffee.example/thanks',
  });
  const ts = Math.floor(Date.now() / 1000);
  const signature = crypto
.createHmac('sha256', process.env.ARIONPAY_API_SECRET)
.update(`${ts}.${body}`)
.digest('hex');

  // ARIONPAY_BASE_URL: the API address from the docs
  const res = await fetch(`${process.env.ARIONPAY_BASE_URL}/api/v1/invoices`, {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'x-api-key': process.env.ARIONPAY_API_KEY, // pk_...
  'x-timestamp': String(ts),
  'x-signature': signature,
},
body,
  });
  const data = await res.json();
  if (!res.ok) throw new Error(`${res.status}: ${data.error}`);
  return data.invoice_url; // save data.id with the order, then send your customer here
}