API Développeur
RobinPay est une passerelle de paiement auto-custodial. Créez des paiements par programmation, redirigez les clients vers un hébergement de paiement et vérifiez le statut des paiements en temps réel en interrogeant notre API REST.
Pour commencer
Créez un compte et générez une clé API dans votre tableau de bord. Gardez-la secrète — elle n'est affichée qu'une seule fois. Authentifiez chaque requête avec un en-tête Authorization.
URL de base
Toutes les requêtes sont en JSON HTTPS. L'API est versionnée sous /api/v1.
https://pay.robinswebdesign.com/api/v1
Authentification
Envoyez votre clé API secrète dans l'en-tête Authorization. Les clés commencent par pg_sk_. Vos appels sont liés à votre compte et limités en débit par IP.
Authorization: Bearer pg_sk_live_...
Créer un paiement
POST /api/v1/payments crée un paiement et retourne une URL de paiement hébergée. Votre client paie à cette adresse ; les dépôts crypto vont vers une adresse unique surveillée par nos nœuds dédiés, et les cartes/iDEAL fonctionnent en arrière-plan.
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 — Montant à débiter, dans l'unité de la devise (par ex. 49,99).currency — eur ou usd. Par défaut eur.method — Méthode ou tableau de méthodes à accepter ('["btc","ltc","eth","usdt","usdc","zero"]'), ou "auto", ou l'omettre pour accepter toutes les méthodes. Par défaut auto.description — Texte court affiché sur la page de paiement. Max 300 caractères.success_url — URL vers laquelle rediriger le client après un paiement réussi.cancel_url — URL vers laquelle rediriger le client en cas d'annulation.metadata — JSON personnalisé optionnel que vous souhaitez recevoir dans les réponses.La réponse inclut l'id du paiement, le statut et une URL de paiement vers laquelle vous redirigez votre client.
{
"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
}Enregistrer l'id du paiement
Stockez l'id retourné (publicId, ex. pay_9f2k1...) dans votre propre base de données avec votre commande. Vous en aurez besoin plus tard pour vérifier le statut de ce paiement via GET /api/v1/payments/:id — sans lui, il est impossible de retrouver le paiement à partir de la commande.
Récupérer un paiement
GET /api/v1/payments/:id retourne le statut actuel d'un paiement. Interrogez cet endpoint pour suivre un paiement jusqu'à ce qu'il atteigne un état terminal.
curl -X GET https://pay.robinswebdesign.com/api/v1/payments/pay_9f2k1... \ -H "Authorization: Bearer pg_sk_live_..."
Abonnements & récurrent
POST /api/v1/subscriptions lance un abonnement récurrent avec une facturation carte unique. L'URL de paiement retournée est où le client entre sa carte une fois ; chaque période suivante est facturée automatiquement sur la carte enregistrée.
GET /api/v1/subscriptions liste vos abonnements.
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"]}'Lire le statut d'un paiement
GET /api/v1/payments/:id est le moyen de lire le statut actuel d'un paiement. Il n'y a pas de webhooks — interrogez cet endpoint vous-même, quand et comme vous voulez : à la demande, via un minuteur, un cron job, dans un worker en arrière-plan, ou déclenché par n'importe quel événement de votre application. Lorsque le statut est "paid", exécutez la commande. Arrêtez une fois le paiement dans un état terminal (paid, expired ou failed).
Valeurs de statut
- pending — le client paie encore ou la transaction crypto n'est pas encore confirmée.
- paid — entièrement confirmé on-chain / capturé. Exécutez la commande maintenant.
- underpaid — le client a envoyé moins que le montant crypto requis.
- expired — le paiement a expiré sans avoir été payé.
- failed — le paiement a échoué (par ex. expiré avec sous-paiement).
Lire le statut en code
Ces exemples montrent le flux complet dans différents langages : créer un paiement, enregistrer l'id retourné dans votre propre backend, puis vérifier le statut quand vous voulez. Utilisez ce que vous avez déjà — vous appelez simplement la même URL. Ci-dessous, un paiement effectué ("paid") pour voir les champs à lire.
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"
}Liens de paiement
Sans code. Créez un lien de paiement dans le tableau de bord (/l/:slug) et partagez-le, ou intégrez-le à votre site. Les paiements crypto sont confirmés automatiquement ; les cartes et iDEAL sont traités instantanément.
Erreurs & limites de débit
Les erreurs sont retournées en JSON {"error": "message"} avec le code HTTP approprié. Les requêtes sont limitées en débit par IP (120 par minute). En cas de 429, attendez et réessayez.
- 401 — clé API manquante/ invalide
- 429 — limite de débit dépassée