Zum Inhalt springen
ArionPay

Wissensdatenbank · 5 Min. Lesezeit

REST-API: Eine Rechnung erstellen

Erstellen Sie Rechnungen von Ihrem Server aus mit einer HMAC-signierten Anfrage und leiten Sie den Kunden zur Bezahlseite weiter.

REST-API: Eine Rechnung erstellen

Authentifizierung

Jede Anfrage enthält drei Header:

  • x-api-key: der öffentliche Schlüssel Ihres Shops (er beginnt mit pk_).
  • x-timestamp: die aktuelle Unix-Zeit in Sekunden. Sie darf höchstens 5 Minuten von unserer Uhr abweichen.
  • x-signature: der HMAC-SHA256 von timestamp.body als Hex-Wert, signiert mit dem API-Secret Ihres Shops.

Senden Sie auch Content-Type: application/json. Jede signierte Anfrage wird nur einmal akzeptiert. Warten Sie daher mindestens eine Sekunde, bevor Sie dieselbe Anfrage erneut senden, und signieren Sie sie neu. Um das API-Secret im Dashboard anzuzeigen, ist die Zwei-Faktor-Anmeldung mit einer Authenticator-App nötig.

Rechnung erstellen

Senden Sie POST /api/v1/invoices mit amount und currency. Optionale Felder sind unter anderem orderId, allowedAssets, expiresMin (5 bis 1440), successUrl, cancelUrl und metadata. Die Antwort enthält invoice_url: Leiten Sie Ihren Kunden dorthin weiter.

Setzen Sie test: true, um eine Testrechnung zu erstellen, die nicht mit echtem Geld bezahlt werden kann. Die vollständige Referenz finden Sie in der API-Dokumentation.

// 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
}