Passer au contenu principal

​
Statuts

StatutTypeSignification
pendingTransitoirePayout créé ; pas encore soumis à la passerelle.
processingTransitoireSoumis à la passerelle ; en attente de vérification.
completedFinalVérifié avec succès par Orqex.
failedFinalVérification en échec. Consultez l’objet failure.
Seuls pending et processing sont non terminaux. Traitez completed et failed comme définitifs et agissez en conséquence.

​
Comment Orqex finalise un payout

Orqex ne fait jamais confiance à la réponse inline de la passerelle comme résultat autoritaire. Après la soumission, le statut est résolu via deux mécanismes :
  1. Webhook / callback de la passerelle — lorsque la passerelle poste un événement de résultat à Orqex, le payout est vérifié et transitionné immédiatement.
  2. Poller de réconciliation — un job en arrière-plan récupère périodiquement le statut du payout auprès de la passerelle. Cela couvre les passerelles qui ne livrent pas leurs callbacks de façon fiable.
Cette approche « vérifier, ne pas faire confiance » signifie qu’un payout peut rester en processing pendant quelques minutes à quelques heures selon la passerelle et le réseau. Concevez votre intégration autour des webhooks payout pour la notification la plus rapide.

​
Détails de l’échec

Lorsqu’un payout atteint failed, l’objet failure est renseigné : 
{
  "failure": {
    "code": {
      "value": "INSUFFICIENT_BALANCE",
      "category": "GATEWAY_ERROR",
      "message": "The gateway account has insufficient balance to process this payout."
    },
    "message": "The gateway account has insufficient balance to process this payout."
  }
}
​
failure.code
object|null
​
failure.message
string|null
Message lisible par l’humain de premier niveau (miroir de failure.code.message).

​
Catégories d’échec

CatégorieSignification
VALIDATION_ERRORRequête rejetée avant soumission : champ invalide ou règle de validation non respectée.
RECIPIENT_ERRORCorrigeable par le destinataire : compte invalide, numéro non enregistré.
INSUFFICIENT_FUNDSLa passerelle ou le compte source ne dispose pas de fonds suffisants.
GATEWAY_ERRORErreur ou rejet côté fournisseur.
TELCO_ERRORDéfaillance côté réseau mobile ou opérateur télécom.
MERCHANT_CONFIG_ERRORMauvaise configuration : règle de routage manquante, identifiants passerelle invalides.
PLATFORM_ERRORIncident plateforme. Contactez le support si persistant.

​
Note sur le règlement crypto

Pour les payouts crypto, Orqex effectue une conversion de règlement : le payout est libellé dans la devise de votre projet, et le montant crypto équivalent est calculé et transmis au moment de l’exécution. Le taux de change utilisé est enregistré sur le payout. Aucune conversion de devise n’est appliquée pour les méthodes non-crypto.
Il n’y a pas de nouvelle tentative automatique ni de basculement pour les payouts en échec. Si un payout échoue, créez-en un nouveau explicitement après avoir résolu le problème sous-jacent.