DocsTableau de bord

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 à 128obligatoire
amountstringobligatoire
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.