API REST : créer une facture
Authentification
Chaque requête porte trois en-têtes :
x-api-key: la clé publique de votre boutique (elle commence parpk_).x-timestamp: l’heure Unix actuelle en secondes. Elle ne doit pas s’écarter de plus de 5 minutes de notre horloge.x-signature: le HMAC-SHA256 en hexadécimal detimestamp.body, signé avec le secret API de votre boutique.
Envoyez aussi Content-Type: application/json. Chaque requête signée n’est acceptée qu’une fois : attendez donc au moins une seconde avant de renvoyer la même requête, et signez-la à nouveau. Afficher le secret API dans le tableau de bord demande la connexion à deux facteurs avec une application d’authentification.
Créer une facture
Envoyez POST /api/v1/invoices avec amount et currency. Parmi les champs facultatifs : orderId, allowedAssets, expiresMin (de 5 à 1440), successUrl, cancelUrl et metadata. La réponse contient invoice_url : envoyez-y votre client.
Indiquez test: true pour créer une facture test qui ne peut pas être payée avec de l’argent réel. La référence complète se trouve dans la documentation 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
}