REST API: crear una factura
Autenticación
Cada solicitud lleva tres encabezados:
x-api-key: la clave pública de tu tienda (empieza porpk_).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 detimestamp.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
}