Skip to main content

Création d’un ordre de paiement

Le Connecteur transmet les ordres de paiement via une requête HTTP POST sécurisée.
Les informations de sécurité sont portées exclusivement par les en-têtes HTTP et font référence au corps JSON signé.

Réponse attendue du service bancaire

Le service bancaire DOIT retourner une réponse HTTP conforme aux règles décrites ci-dessous.
Le code HTTP détermine explicitement la présence ou non d’un corps de réponse.
Toute déviation à ces règles entraîne un rejet de l’intégration.

Cas 1 — HTTP 202 Accepted (traitement asynchrone)

Description

Le code 202 Accepted indique que :
  • l’ordre a été accepté techniquement,
  • le traitement bancaire est différé,
  • aucun statut métier final n’est encore disponible.

Règle obligatoire

  • Aucun corps de réponse ne doit être retourné
  • Le header Content-Length doit être égal à 0
  • Le statut final DEVRA être transmis ultérieurement via callback

Cas 2 — HTTP 200 OK (traitement synchrone)

Description

Le code 200 OK indique que :
  • l’ordre a été traité immédiatement,
  • un statut métier est disponible,
  • le résultat est définitif.

Règle obligatoire

  • Le corps de réponse est OBLIGATOIRE
  • Le corps DOIT respecter le format standard décrit ci-dessous

Format du corps de réponse (HTTP 200)

Règles sur le champ status

Contraintes

  • SUCCESS et FAILED sont des statuts finaux
  • PENDING implique obligatoirement un callback ultérieur
  • Un statut final ne peut jamais être modifié

Cas particulier — FAILED

Lorsque status = FAILED :
  • reasonCode est OBLIGATOIRE
  • reasonMessage est OBLIGATOIRE
  • Le code doit appartenir à la nomenclature des erreurs métier documentées
Example

Règles de cohérence (IMPORTANT)

  • Un HTTP 200 sans body est invalide
  • Un HTTP 202 avec body est invalide
  • Le reference DOIT correspondre exactement à la référence reçue
  • Le bank_reference est obligatoire pour toute traçabilité bancaire
  • Le timestamp DOIT être exprimé en UTC

Cas 3 — HTTP 4xx/5xx

Gestion d’erreur standard