Aller au contenu
ArionPay

Base de connaissances · 5 min de lecture

API REST : créer une facture

Créez des factures depuis votre serveur avec une requête signée en HMAC et envoyez le client vers la page de paiement.

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 par pk_).
  • 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 de timestamp.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
}