Paiements
Créer un paiement
POST/v1/payment-intentspayments:write
Autorisation payments:write. Enregistre un paiement et répond 202 à l’état PLANNED : rien n’est encore débité. Sans connection_id, PayHaze choisit le compte parmi vos comptes admissibles et garde la raison de son choix. La même référence de commande retrouve le même paiement. Sur une connexion réelle, une fois 500 € encaissés gratuitement, sans abonnement PayHaze : 402 production_offer_used, rien n’est créé.
En-têtes
AuthorizationBearer pos_key_…obligatoire- Clé de serveur, pour tout l’espace. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire- L’espace marchand concerné (mrc_…).
Idempotency-Keystringobligatoire- La même clé avec la même demande retrouve la première réponse ; avec une autre demande : 409.
Corps
merchant_referencestring, 1 à 128obligatoireamountstringobligatoire- Le montant en texte, avec ses décimales (124.90). Les limites de chaque devise : GET /v1/currencies.
currencystringobligatoire- Code de la devise sur 3 lettres (EUR, USD…).
capture_mode"automatic" | "manual"obligatoire- manual : réserver puis capturer plus tard, si le compte le permet.
connection_idstring- Le compte à utiliser. Sans lui, PayHaze choisit parmi vos comptes admissibles et garde la raison de son choix ; le compte ne change plus ensuite.
payment_method_idstring- Un moyen enregistré : débité tout de suite sur son propre compte, jamais présenté à un autre. Si la banque demande l’acheteur, l’état passe à REQUIRES_ACTION.
customer_referencestring, 1 à 128- L’acheteur, tel que votre boutique le nomme. Obligatoire avec save_method.
customerCustomer- Le nom et l’e-mail de l’acheteur, facultatifs : vous le retrouvez dans le tableau de bord (liste, recherche, fiche, export).
save_methodobject- L’acheteur a accepté que sa carte serve aux achats suivants. Le compte doit pouvoir la garder (Stripe) ; sinon 409, rien n’est créé.
alma_orderAlmaOrder- Réservé à Alma.
Réponses
- 202Demande enregistrée
- 400Requête invalide
- 401Clé absente ou invalide
- 402Service restreint
- 403Autorisation ou espace refusé
- 404Ressource introuvable
- 409Conflit avec une demande existante
- 422Impossible à traiter
- 429Trop de demandes, réessayez plus tard
- 503Service momentanément indisponible
Une erreur ne vaut jamais paiement. Le corps donne code, message, request_id et retry_action ; renvoyez la même Idempotency-Key si retry_action le propose.