FedCheckout
AccueilDocumentationTableau de bord

Démarrer

Vue d'ensembleMode test

Intégrer

Référence de l'APIWebhooksMoyens de paiement

Référence

Codes d'erreurJournal des versions

Codes d'erreur

Le code est stable : décide dessus, jamais sur le texte. Une erreur ne répond jamais 200.

Authentification

La clé, ses permissions, son usage.

CodeMessage renvoyé
API_KEY_EXPIREDCette clé API a expiré.
API_KEY_IN_QUERYLa clé API ne doit jamais circuler dans l'URL. Utilise l'en-tête Authorization.
API_KEY_REVOKEDCette clé API a été révoquée.
AUTH_REQUIREDConnexion nécessaire pour ce moyen de paiement.
FORBIDDENAction réservée.
INSUFFICIENT_SCOPECette clé n'a pas la permission nécessaire.
INVALID_API_KEYClé API invalide.
RATE_LIMITEDTrop de requêtes. Ralentis.
UNAUTHORIZEDClé API manquante. Utilise l'en-tête Authorization: Bearer fco_live_…

Requête

Ce que la requête demande n'est pas recevable.

CodeMessage renvoyé
EXTERNAL_REFERENCE_EXISTSCette référence externe désigne déjà un paiement.
IDEMPOTENCY_CONFLICTCette clé d'idempotence a déjà servi pour une requête différente. Change de clé, ou renvoie exactement le même corps.
IDEMPOTENCY_KEY_REQUIREDL'en-tête Idempotency-Key est obligatoire sur cette route.
INVALID_AMOUNTMontant invalide pour cette devise.
INVALID_REQUESTRequête invalide.
RETURN_URL_NOT_ALLOWEDAdresse de retour non autorisée. Déclare-la sur ton application.
TERMS_REQUIREDIl faut accepter les conditions.
UNKNOWN_ACTIONAction inconnue.
UNSUPPORTED_CURRENCYDevise non prise en charge. FedCheckout accepte GDS et USD.

Paiement

L'état du paiement empêche l'opération.

CodeMessage renvoyé
INSUFFICIENT_FUNDSSolde insuffisant.
PAYMENT_BLOCKEDPaiement refusé par les règles de sécurité.
PAYMENT_CANCELLEDCe paiement a été annulé par le marchand.
PAYMENT_DISPUTEDCe paiement fait l'objet d'une contestation.
PAYMENT_EXPIREDCe paiement a expiré.
PAYMENT_FAILEDLe paiement a échoué.
PAYMENT_METHOD_UNAVAILABLECe moyen de paiement n'est pas disponible pour ce paiement.
PAYMENT_NOT_FOUNDPaiement introuvable.
PAYMENT_PROCESSINGUn paiement est déjà en cours pour cette commande.
PROVIDER_UNAVAILABLEMoyen de paiement momentanément indisponible.
REFUND_NOT_ALLOWEDCe remboursement n'est pas possible.
REFUND_NOT_FOUNDRemboursement introuvable.

Compte marchand

Le compte, l'application, le mode réel.

CodeMessage renvoyé
APPLICATION_DISABLEDCette application est désactivée.
APPLICATION_NOT_FOUNDApplication introuvable.
COMPTE_INCONNUCe compte Fed ID n'est pas rattaché à un compte de paiement.
LIMITE_APPLICATIONSDix applications au maximum.
LIMITE_CLESCinq clés actives au maximum par mode.
LIMITE_WEBHOOKSTrois destinations de webhook au maximum par mode.
LIVE_NOT_ENABLEDLe mode réel n'est pas ouvert sur ce compte.
MERCHANT_NAME_REFUSEDCe nom de marchand ne peut pas être utilisé.
MERCHANT_PENDINGCe compte marchand n'est pas encore actif.
MERCHANT_REQUIREDIl faut un compte marchand pour cette action.
MERCHANT_RESTRICTEDCe compte marchand est restreint.
MERCHANT_SUSPENDEDCe compte marchand est suspendu.
SIGNUP_CLOSEDLes inscriptions marchandes sont fermées.
TEST_MODE_DISABLEDLe mode test est fermé.
WEBHOOK_NOT_FOUNDDestination de webhook introuvable.

Page de paiement

Le lien ou la session ouverte par le client.

CodeMessage renvoyé
LINK_EXHAUSTEDCe lien de paiement a déjà servi.
LINK_EXPIREDCe lien de paiement a expiré.
LINK_NOT_FOUNDCe lien de paiement n'existe pas.
SESSION_CLOSEDCette page de paiement est fermée.
SESSION_EXPIREDCette page de paiement a expiré.
SESSION_NOT_FOUNDCette page de paiement n'existe pas.

Service

Ce n'est pas toi, c'est nous.

CodeMessage renvoyé
INTERNALErreur interne.
SERVICE_UNAUTHORIZEDService indisponible.
SERVICE_UNAVAILABLEFedCheckout est momentanément fermé.

Forme d'une erreur

{
  "error": {
    "code": "INSUFFICIENT_FUNDS",
    "message": "Solde insuffisant.",
    "request_id": "req_3XSY…"
  }
}

Le request_id est le même que l'en-tête FedCheckout-Request-Id : garde-le dans tes journaux, c'est ce qui permet de retrouver l'appel.

FedCheckout — une infrastructure de paiement de Fed Digital, Gonaïves, Haïti.
DocumentationConditionsConfidentialitéRemboursementsFedTopUp