Démarrer

Une API de paiement pour tous vos prestataires

Vous intégrez PayHaze une fois, côté serveur. Stripe, PayPal, Adyen et les autres se branchent derrière : même création de paiement, mêmes notifications, mêmes erreurs, quel que soit le compte qui encaisse.

DémarrerVoir le démarrage rapide

Exemples. Les appels sont ceux du démarrage rapide de la documentation.

Ce que fait l’API

Une API REST en JSON, décrite par un contrat OpenAPI et une référence en français : 109 opérations, chacune avec ses droits, ses champs et ses réponses. Vérifié dans le produit le 9 octobre 2026.

Encaisser

  • Un paiement : montant, devise, référence
  • Une caisse hébergée, à vos couleurs
  • Capture immédiate ou différée
  • Remboursement complet ou partiel

Sans double paiement

  • Une clé d’idempotence par demande
  • Même référence, même paiement
  • Rejouée, la demande rend sa 1re réponse
  • Un doute ? On relit, on ne recrée pas

Notifications signées

  • Paiements, remboursements, litiges
  • Signature HMAC-SHA256 horodatée
  • Jusqu’à 8 envois en cas d’échec
  • Rejouables depuis le tableau de bord

Erreurs lisibles

  • Un code et un message
  • Un request_id pour nous écrire
  • L’action à suivre, dans la réponse
  • Le même format sur toutes les routes

Test et réel

  • X-Environment : test ou live
  • Une caisse de test à part
  • Des clés limitées à leurs droits
  • Gratuit jusqu’à 500 € encaissés

Au-delà du paiement

  • Abonnements et plans
  • Liens de paiement
  • La décision de routage de chaque paiement
  • Le catalogue des devises

Une erreur qui dit quoi faire.

Chaque erreur porte un code, un message, un request_id et l’action à suivre : corriger la demande, s’authentifier, réessayer la même demande plus tard, relire l’opération en cours ou vérifier les droits de la clé.

Voir toutes les erreurs
403Réponse de l’API
{
  "code": "scope_forbidden",ce qui ne va pas
  "message": "Forbidden",
  "request_id": "req_…",à nous donner
  "retry_action": "check_permissions"vérifier les droits de la clé
}

Un premier paiement, en trois appels.

Le démarrage rapide de la documentation, en résumé. Avec une connexion de test, aucun argent ne bouge.

  1. 1Créez le paiementDepuis votre serveur, avec votre référence de commande et une clé d’idempotence.
  2. 2Ouvrez la caisseUne session de caisse, puis l’acheteur part sur pay.payhaze.com.
  3. 3Attendez la confirmationpayment.updated, signée. Livrez quand state vaut SUCCEEDED.

Questions sur l’API.

Avant d’écrire votre intégration.

Dans quel langage intégrer PayHaze ?
Celui de votre serveur : l’API parle REST et JSON. Chaque guide donne l’appel en cURL, et le contrat OpenAPI public décrit chaque route, de quoi générer un client dans votre langage.
Faut-il changer mon code pour ajouter un prestataire ?
Non. Vous branchez le compte dans Connexions avec ses clés ; vos appels restent les mêmes et le routage le prend en compte.
Les numéros de carte passent-ils par mon serveur ?
Non. L’acheteur tape sa carte dans les champs du prestataire, dans la caisse : ni votre serveur ni PayHaze ne voient le numéro ni le code de sécurité.
Combien de requêtes l’API accepte-t-elle ?
Jusqu’à 100 écritures par seconde et par clé. Au-delà, l’API répond 429 avec le délai à attendre dans Retry-After.
Où trouver toutes les routes ?
Dans la référence de l’API, en français : 109 opérations, chacune avec ses droits, ses champs et ses réponses. Le contrat OpenAPI et le fichier llms.txt sont publics.

Créez votre première clé.

Essayez avec vos clés de test. Gratuit jusqu’à 500 € encaissés, sans carte bancaire.

DémarrerVoir le démarrage rapide