Développeurs

Intégration en quatre étapes

API REST, JSON, requêtes signées. La documentation avec exemples Node.js est ouverte sans inscription.

Documentation API Obtenir les clés

Étape 1
Signez la requête
HMAC-SHA256 de l’horodatage, de la méthode, du chemin et du hash du corps. La clé ne quitte jamais votre serveur.
```
X-Shop-Id:    shop_…
X-Timestamp:  1793400000
X-Signature:  hex(HMAC-SHA256(secret_key,
  timestamp ⏎ METHOD ⏎ path ⏎ sha256(body)))
```

Étape 2

Créez un paiement

Montant en unités minimales. Répéter avec la même Idempotency-Key renvoie le même paiement.

POST /v1/payments
Idempotency-Key: 4f1c…

{ "orderId": "A-1001", "amount": 24990,
  "currency": "EUR",
  "returnUrl": "https://shop.example/thanks" }

Étape 3
Envoyez le client payer
La page affiche les moyens du pays et de la devise, encaisse le paiement et renvoie le client chez vous.
```
→ 201
{ "id": "pay_…", "status": "created",
  "checkoutUrl": "https://pay…/c/…" }
```
Étape 4
Recevez le webhook
Vérifiez la signature et marquez la commande comme payée. Sans réponse 2xx, nous réessayons pendant deux jours.
```
POST https://shop.example/payos/webhook
X-Payos-Signature: v1=…

{ "type": "payment.succeeded",
  "data": { "orderId": "A-1001", … } }
```

Commencez à accepter des paiements

Inscrivez-vous et faites vérifier votre société dans l’espace marchand. Les clés API sont délivrées dès que votre boutique est approuvée.

Commencer Documentation API