Entwickler-API
RobinPay ist ein selbstverwalteter Payment Gateway. Erstellen Sie Zahlungen programmgesteuert, leiten Sie Kunden an ein gehostetes Checkout weiter und prüfen Sie den Zahlungsstatus in Echtzeit per Polling über unsere REST-API.
Erste Schritte
Erstellen Sie ein Konto und generieren Sie einen API-Schlüssel in Ihrem Dashboard. Bewahren Sie ihn geheim – er wird nur einmal angezeigt. Authentifizieren Sie jede Anfrage mit einem Authorization-Header.
Basis-URL
Alle Anfragen sind HTTPS-JSON. Die API ist versioniert unter /api/v1.
https://pay.robinswebdesign.com/api/v1
Authentifizierung
Senden Sie Ihren geheimen API-Schlüssel im Authorization-Header. Schlüssel beginnen mit pg_sk_. Ihre Aufrufe sind an Ihr Konto gebunden und werden pro IP gedrosselt.
Authorization: Bearer pg_sk_live_...
Zahlung erstellen
POST /api/v1/payments erstellt eine Zahlung und gibt eine gehostete checkout_url zurück. Ihr Kunde zahlt dort; Krypto-Einzahlungen gehen an eine eindeutige Adresse, die von unseren dedizierten Nodes überwacht wird, und Karte/iDEAL laufen im Hintergrund.
curl -X POST https://pay.robinswebdesign.com/api/v1/payments \
-H "Authorization: Bearer pg_sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 49.99,
"currency": "eur",
"method": ["btc","ltc","eth","usdt","usdc","zero"],
"description": "Order #1234",
"success_url": "https://yoursite.com/thanks",
"cancel_url": "https://yoursite.com/checkout",
"metadata": { "order_id": "1234" }
}'amount — Abzubetragender Betrag in der Währungseinheit (z. B. 49.99).currency — eur oder usd. Standardwert ist eur.method — Methode oder Array von Methoden zum Akzeptieren ('["btc","ltc","eth","usdt","usdc","zero"]'), oder "auto", oder auslassen, um alle Methoden zu akzeptieren. Standardwert ist auto.description — Kurzer Text, der am Checkout angezeigt wird. Maximal 300 Zeichen.success_url — URL, an die der Kunde nach einer erfolgreichen Zahlung weitergeleitet wird.cancel_url — URL, an die der Kunde weitergeleitet wird, wenn er abbricht.metadata — Optionale benutzerdefinierte JSON-Daten, die in den Antworten zurückgegeben werden.Die Antwort enthält die Zahlungs-ID, den Status und eine checkout_url, an die Sie Ihren Kunden weiterleiten.
{
"id": "pay_9f2k1...",
"object": "payment",
"status": "pending",
"method": "auto",
"title": "Order #1234",
"amount": { "cents": 4999, "currency": "eur" },
"crypto": { "asset": "btc", "amount": "0.00074", "address": "bc1q...", "received": "0", "confirmations": 0 },
"transaction_ids": [],
"metadata": { "order_id": "1234" },
"checkout_url": "https://pay.robinswebdesign.com/pay/pay_9f2k1...",
"created_at": "2026-08-31T12:00:00.000Z",
"expires_at": "2026-08-31T12:15:00.000Z",
"paid_at": null
}Zahlungs-ID speichern
Speichern Sie die zurückgegebene id (publicId, z. B. pay_9f2k1...) zusammen mit Ihrer Bestellung in Ihrer eigenen Datenbank. Sie benötigen sie später, um den Status dieser Zahlung per GET /api/v1/payments/:id zu prüfen – ohne sie lässt sich die Zahlung nicht anhand der Bestellung finden.
Zahlung abrufen
GET /api/v1/payments/:id gibt den aktuellen Status einer Zahlung zurück. Pollen Sie diesen Endpunkt, um eine Zahlung zu verfolgen, bis sie einen Endzustand erreicht.
curl -X GET https://pay.robinswebdesign.com/api/v1/payments/pay_9f2k1... \ -H "Authorization: Bearer pg_sk_live_..."
Abonnements & Wiederkehrende Zahlungen
POST /api/v1/subscriptions startet ein wiederkehrendes Abonnement mit einmaliger Kartenzahlung. Die zurückgegebene checkout_url ist der Ort, an dem der Kunde seine Karte einmal eingibt; jede folgende Periode wird automatisch von der gespeicherten Karte belastet.
GET /api/v1/subscriptions listet Ihre Abonnements auf.
curl -X POST https://pay.robinswebdesign.com/api/v1/subscriptions \
-H "Authorization: Bearer pg_sk_live_..." \
-H "Content-Type: application/json" \
-d '{"amount": 49.99, "currency": "eur", "method": ["btc","ltc","eth","usdt","usdc","zero"]}'Zahlungsstatus lesen
GET /api/v1/payments/:id ist der Weg, um den aktuellen Status einer Zahlung zu lesen. Es gibt keine Webhooks – prüfen Sie diesen Endpunkt selbst, wann und wie Sie möchten: auf Abruf, per Timer, aus einem Cron-Job, in einem Hintergrund-Worker oder ausgelöst durch jedes Ereignis in Ihrer App. Wenn der Status "paid" ist, erfüllen Sie die Bestellung. Beenden Sie die Prüfung, sobald die Zahlung einen Endzustand (paid, expired oder failed) erreicht.
Statuswerte
- pending – Der Kunde zahlt noch, oder die Krypto-Transaktion ist noch nicht bestätigt.
- paid – Vollständig on-chain bestätigt / erfasst. Erfüllen Sie jetzt die Bestellung.
- underpaid – Der Kunde hat weniger als den erforderlichen Kryptobetrag gesendet.
- expired – Die Zahlung ist ohne Bezahlung abgelaufen.
- failed – Die Zahlung ist fehlgeschlagen (z. B. abgelaufen, während der Betrag nicht ausreichte).
Status im Code lesen
Diese Beispiele zeigen den vollständigen Ablauf in verschiedenen Sprachen: Zahlung erstellen, die zurückgegebene id in Ihrem eigenen Backend speichern und dann den Status prüfen, wann immer Sie möchten. Verwenden Sie, was Sie bereits haben – Sie rufen einfach dieselbe URL auf. Unten sehen Sie eine abgeschlossene ("paid") Zahlung, damit Sie die Felder erkennen.
const API_KEY = process.env.ROBINPAY_API_KEY; // pg_sk_...
const BASE = 'https://pay.robinswebdesign.com/api/v1';
async function api(path, options = {}) {
const res = await fetch(BASE + path, {
...options,
headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${API_KEY}`, ...options.headers },
});
return res.json();
}
// 1. CREATE a payment, then SAVE the returned id to your own DB
async function createPayment(order) {
const payment = await api('/payments', {
method: 'POST',
body: JSON.stringify({
amount: 49.99,
currency: 'eur',
method: ['btc', 'ltc', 'eth'],
description: `Order #${order.id}`,
success_url: 'https://yoursite.com/thanks',
cancel_url: 'https://yoursite.com/checkout',
metadata: { order_id: order.id },
}),
});
// SAVE this id — you need it later to check status
await saveOrder({ id: order.id, robinpayId: payment.id });
return payment; // payment.checkout_url -> redirect the customer here
}
// 2. CHECK status at any time using the id you saved
async function checkStatus(robinpayId) {
const payment = await api(`/payments/${robinpayId}`);
if (payment.status === 'paid') {
await fulfillOrder(payment.metadata.order_id);
}
return payment.status;
}
// Example: call checkStatus on demand, on a timer, from a cron job,
// or from any event in your app — whenever you like.
const payment = await createPayment({ id: 1234 });
saveOrder({ id: 1234, robinpayId: payment.id }); // never lose this
setInterval(() => checkStatus(payment.id), 30_000); // your own schedule{
"id": "pay_9f2k1...",
"object": "payment",
"status": "paid",
"method": "auto",
"title": "Order #1234",
"amount": { "cents": 4999, "currency": "eur" },
"crypto": { "asset": "btc", "amount": "0.00074", "address": "bc1q...", "received": "0.00074", "confirmations": 6 },
"transaction_ids": ["tx_79f2..."],
"metadata": { "order_id": "1234" },
"created_at": "2026-08-31T12:00:00.000Z",
"expires_at": "2026-08-31T12:15:00.000Z",
"paid_at": "2026-08-31T12:04:30.000Z"
}Zahlungslinks
Kein Code erforderlich. Erstellen Sie einen Zahlungslink im Dashboard (/l/:slug) und teilen Sie ihn, oder betten Sie ihn auf Ihrer Website ein. Krypto-Zahlungen werden automatisch bestätigt; Karten- und iDEAL-Zahlungen werden sofort verarbeitet.
Fehler & Ratenlimits
Fehler werden als JSON {"error": "message"} mit dem entsprechenden HTTP-Statuscode zurückgegeben. Anfragen werden pro IP gedrosselt (120 pro Minute). Bei 429: Zurücktreten und erneut versuchen.
- 401 – Fehlender/ungültiger API-Schlüssel
- 429 – Ratenlimit überschritten