PayHazeDocs
⌘ K
Tableau de bord

Documentation

Un premier paiement de test en trois appels, puis chaque sujet en détail : prestataires, remboursements, notifications, erreurs.

Démarrage rapideRéférence de l’API
POST/v1/payment-intentscURL
curl -X POST "$PAYMENT_OS_API/v1/payment-intents" \
  -H "Authorization: Bearer $PAYMENT_OS_KEY" \
  -H "X-Merchant-ID: $MERCHANT_ID" \
  -H "X-Environment: test" \
  -H "Idempotency-Key: CMD-2026-0412-creation" \
  -d '{
    "merchant_reference": "CMD-2026-0412",
    "amount": "124.90",
    "currency": "EUR",
    "capture_mode": "automatic",
    "connection_id": "con_5b1d7e2a-0c4f-4e8b-a9d3-6f2e1c8b4a70"
  }'

202Demande enregistrée, pas encore un paiement : "state": "PLANNED"

Guides

Commencer

Démarrage rapideUn paiement de test, du serveur à la confirmation.Environnement de testClés pos_test_, simulateur, cas difficiles.Connecter un prestataireColler une clé, adresse de notification.SDK et boutique d’exemple@payhaze/sdk côté serveur, redirection vers la caisse.

Encaisser

Paiement completCaisse, authentification, capture différée.RemboursementMontant disponible, remboursement partiel.AbonnementsPlans, relances, action de l’acheteur.

Fiabilité

Événementspayment.updated, signature, nouvelles tentatives.ErreursCodes, request_id et action à suivre.IdempotenceRejouer une demande sans double paiement.

Changer de prestataire

Limites de portabilitéCe qui suit, ce qui reste chez l’ancien.MigrationPasser d’une intégration directe à PayHaze.

Trois règles avant la production

Les erreurs d’intégration qui coûtent de l’argent. Chacune a son guide.

202 n’est pas un paiement

Une création acceptée renvoie 202 et l’état PLANNED. L’argent n’est acquis qu’à l’état SUCCEEDED.

Guide : Paiement complet

Une clé d’idempotence par demande

Renvoyez la même Idempotency-Key après une coupure : vous retrouvez la même demande, jamais un second paiement.

Guide : Idempotence

Livrez après la notification

Le retour de l’acheteur sur votre site ne prouve rien. Attendez payment.updated, signée, ou lisez le paiement côté serveur.

Guide : Événements