DocsTableau de bord

Remboursements

Noter un remboursement fait depuis votre portefeuille

POST/v1/payment-intents/{id}/noted-refundsrefunds:write

Requires refunds:write and the second factor. 37 (Figma 703:42): PayHaze holds no key that sends crypto; the merchant refunds from their own wallet, then notes the amount (in the payment's currency) and the transaction (64 hexadecimal characters, 0x first or not). PayHaze records it as a refund made outside PayHaze, journaled as refund.noted, without checking it on the network; the same transaction noted again is the same refund. 409 payment_not_refundable for a payment not confirmed in crypto, 409 insufficient_refundable_balance above what remains.

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_…).

Paramètres

iddans le cheminobligatoire

Corps

amountstringobligatoire
transactionstringobligatoire

Réponses

201Créé
400Requête invalide
401Clé absente ou invalide
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.