REST-API: Eine Rechnung erstellen
Authentifizierung
Jede Anfrage enthält drei Header:
x-api-key: der öffentliche Schlüssel Ihres Shops (er beginnt mitpk_).x-timestamp: die aktuelle Unix-Zeit in Sekunden. Sie darf höchstens 5 Minuten von unserer Uhr abweichen.x-signature: der HMAC-SHA256 vontimestamp.bodyals 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
}