Ontwikkelaars-API
RobinPay is een zelf-custodial betaalgateway. Maak betalingen programmatisch aan, stuur klanten naar een hosted checkout en controleer de betalingsstatus realtime door onze REST API te pollen.
Aan de slag
Maak een account aan en genereer een API-sleutel in je dashboard. Houd deze geheim — deze wordt slechts één keer getoond. Authenticatie van elk verzoek met een Authorization-header.
Basis-URL
Alle verzoeken zijn HTTPS JSON. De API is versioned onder /api/v1.
https://pay.robinswebdesign.com/api/v1
Authenticatie
Stuur je geheime API-sleutel mee in de Authorization-header. Sleutels beginnen met pg_sk_. Je aanroepen zijn gekoppeld aan je account en worden per IP beperkt.
Authorization: Bearer pg_sk_live_...
Een betaling aanmaken
POST /api/v1/payments maakt een betaling aan en retourneert een hosted checkout_url. Je klant betaalt daar; crypto-stortingen gaan naar een uniek adres dat door onze eigen nodes wordt bewaakt, en kaart/iDEAL worden op de achtergrond verwerkt.
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 — Te berekenen bedrag, in de valuta-eenheid (bijv. 49,99).currency — eur of usd. Standaard is eur.method — Methode of array van methoden om te accepteren ('["btc","ltc","eth","usdt","usdc","zero"]'), of "auto", of weglaten om alle methoden te accepteren. Standaard is auto.description — Korte tekst op de checkout. Max. 300 tekens.success_url — URL om de klant naartoe te redirecten na een succesvolle betaling.cancel_url — URL om de klant naartoe te redirecten bij annulering.metadata — Optionele aangepaste JSON die je terug wilt zien in responses.Het antwoord bevat het betalings-id, de status en een checkout_url waarnaar je je klant redirect.
{
"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
}Het betalings-id opslaan
Sla het geretourneerde id (publicId, bijv. pay_9f2k1...) op in je eigen database samen met je bestelling. Je hebt het later nodig om de status van deze betaling te controleren via GET /api/v1/payments/:id — zonder dit id kun je de betaling niet terugvinden aan de hand van de bestelling.
Een betaling ophalen
GET /api/v1/payments/:id retourneert de huidige status van een betaling. Poll deze endpoint om een betaling te volgen totdat deze een eindstatus bereikt.
curl -X GET https://pay.robinswebdesign.com/api/v1/payments/pay_9f2k1... \ -H "Authorization: Bearer pg_sk_live_..."
Abonnementen & terugkerende
POST /api/v1/subscriptions start een terugkerend abonnement met een eenmalige kaartbetaling. De geretourneerde checkout_url is waar de klant eenmalig zijn kaart invoert; elke volgende periode wordt automatisch belast op de opgeslagen kaart.
GET /api/v1/subscriptions lijst je abonnementen op.
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"]}'Betalingsstatus lezen
GET /api/v1/payments/:id is de manier om de huidige status van een betaling te lezen. Er zijn geen webhooks — controleer deze endpoint zelf, wanneer en hoe je wilt: op verzoek, via een timer, een cron job, in een achtergrond-worker, of getriggerd door elk event in je app. Wanneer de status "paid" is, voltooi je de bestelling. Stop zodra de betaling een eindstatus (paid, expired of failed) bereikt.
Statuswaarden
- pending — de klant betaalt nog of de crypto-transactie is nog niet bevestigd.
- paid — volledig bevestigd on-chain / vastgelegd. Voltooi nu de bestelling.
- underpaid — de klant heeft minder gestuurd dan het vereiste crypto-bedrag.
- expired — de betaling is verlopen zonder te zijn betaald.
- failed — de betaling is mislukt (bijv. verlopen terwijl onderbetaald).
Status in code lezen
Deze voorbeelden tonen de volledige flow in verschillende talen: maak een betaling aan, sla het geretourneerde id op in je eigen backend en controleer daarna de status wanneer je wilt. Gebruik wat je al hebt — je roept gewoon dezelfde URL aan. Hieronder een voldane ("paid") betaling, zodat je de velden ziet.
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"
}Betaallinks
Geen code nodig. Maak een betaallink in het dashboard (/l/:slug) en deel deze, of embed deze op je site. Crypto-betalingen worden automatisch bevestigd; kaart- en iDEAL-betalingen worden direct verwerkt.
Fouten & snelheidslimieten
Fouten worden geretourneerd als JSON {"error": "message"} met de juiste HTTP-statuscode. Verzoeken worden per IP beperkt (120 per minuut). Bij 429: wacht en probeer opnieuw.
- 401 — ontbrekende/ongeldige API-sleutel
- 429 — snelheidslimiet overschreden