Catalogue des erreurs

Tous les codes d'erreur renvoyés par l'API partenaire v3, avec leur statut HTTP et les endpoints concernés.

Format : voir Conventions. Les messages sont indicatifs ; seul le code fait foi.

Endpoints : C = créer, R = récupérer, L = lister, A = annuler.

400 Bad Request

Code	Endpoints	Message	Action
`INVALID_REQUEST`	C, R, L, A	The request payload is invalid. Check the field types and formats against the API contract.	Corriger la requête (types, formats, champs inconnus).
`INVALID_CURSOR`	L	The pagination cursor is invalid.	Reprendre la pagination sans curseur.
`INVALID_DATE_RANGE`	L	createdFrom must be before or equal to createdTo.	Corriger les bornes.

401 Unauthorized

Code	Endpoints	Message	Action
`MISSING_PARTNER_ID`	C, R, L, A	The authenticated partner identifier is missing.	Vérifier la configuration du client OAuth.

Un jeton absent, invalide ou expiré est rejeté par la gateway (401) avec un format qui lui est propre, sans enveloppe error.code.

404 Not Found

Code	Endpoints	Message
`PRODUCT_NOT_FOUND`	C, L	The product does not exist or is not owned by the partner.
`CUSTOMER_NOT_FOUND`	C	The customer does not exist or is not owned by the partner.
`INVOICE_NOT_FOUND`	R, A	The invoice does not exist or is not owned by the partner.

409 Conflict

Code	Endpoints	Message	Action
`REFERENCE_ALREADY_EXISTS`	C	An invoice with the same partner reference already exists with a different payload.	Utiliser une nouvelle référence, ou rejouer le contenu initial.
`CREATION_ALREADY_IN_PROGRESS`	C	The customer creation is already in progress, retry shortly.	Réessayer après quelques secondes.
`INVOICE_ALREADY_PAID`	C, A	The invoice has already been paid and cannot be cancelled.	Annulation impossible ; en création, concurrence sur une référence déjà payée.
`INVOICE_ALREADY_CANCELLED`	A	The invoice has already been cancelled and cannot be cancelled again.	Aucune ; l'état attendu est atteint.

422 Unprocessable Entity

Code	Endpoints	Message
`PRODUCT_NOT_AVAILABLE`	C	The product is not available for invoice creation.
`AMOUNT_BELOW_MINIMUM`	C	The invoice amount is below the product minimum.
`AMOUNT_ABOVE_MAXIMUM`	C	The invoice amount is above the product maximum.
`AMOUNT_MISMATCH`	C	The invoice amount mismatches.
`CUSTOMER_NOT_ONBOARDED`	C	The customer has not completed onboarding yet.
`CUSTOMER_TYPE_CHANGED`	C	The customer person type cannot change for an existing customer.
`CUSTOMER_IDENTITY_REQUIRED`	C	The customer identity is required when the customer is not known yet.
`INVOICE_EXPIRED`	C	The invoice expiration date must be in the future.

500 Internal Server Error

Code	Endpoints	Message	Action
`SERVICE_FEE_UNAVAILABLE`	C	The invoice service fee could not be computed.	Réessayer plus tard.
`CUSTOMER_PROVISIONING_FAILED`	C	The customer could not be provisioned.	Réessayer plus tard.
`PAYMENT_IN_PROGRESS`	C	The invoice status is still in progress.	Réservé ; non émis à ce jour.

Toute autre erreur inattendue renvoie 500 sans code métier garanti. Les créations peuvent être rejouées sans risque grâce à l'idempotence.

Codes réservés

Ces codes existent dans le contrat mais ne sont pas renvoyés par les endpoints actuels : UNAUTHORIZED, MISSING_PRODUCT_ID, INVALID_INVOICE_UPDATE_REQUEST, PAYMENT_IN_PROGRESS.