La section "Définitions" de chaque produit d’API répertorie les schémas attendus sous ErrorDTO et FieldErrorDTO.
Concernant l’API /checks, qui est la plus utilisée, les situations suivantes entraînent une erreur 400 Bad Request :
| Catégorie | Règle | Exemple de payload |
| IBAN | IBAN sanity check triggered | {"message":"error.validation","fieldErrors":[{"objectName":"entity","field":"paymentIdentity.iban","message":"size must be between 14 and 34"}],"httpStatus":"BAD_REQUEST","httpCode":"400","httpMessage":"Bad Request"} |
| BBAN | BIC sanity check triggered | {"message":"error.validation","fieldErrors":[{"objectName":"entity","field":"paymentIdentity.bic","message":"must match \"^[A-Za-z0-9]{8}([A-Za-z0-9]{3})?$\""}],"httpStatus":"BAD_REQUEST","httpCode":"400","httpMessage":"Bad Request"} |
| BBAN | Should use IBAN in this context | {"message":"error.validation","fieldErrors":[{"objectName":"entity","field":"paymentIdentity.bic","message":"The BIC (XXX) country code corresponds to a country supporting the IBAN. Please use the 'iban' property."}],"httpStatus":"BAD_REQUEST","httpCode":"400","httpMessage":"Bad Request"} |
| BBAN | Missing mandatory properties | {"message":"error.validation","fieldErrors":[{"objectName":"entity","field":"paymentIdentity","message":"At least one of the 'bic' or 'routingCode' property is mandatory."}],"httpStatus":"BAD_REQUEST","httpCode":"400","httpMessage":"Bad Request"} |
| BBAN | BIC not matching the country context | {"message":"error.validation","fieldErrors":[{"objectName":"entity","field":"paymentIdentity","message":"The provided country code is different from the BIC country code."}],"httpStatus":"BAD_REQUEST","httpCode":"400","httpMessage":"Bad Request"} |
| Countries | Missing mandatory properties | {"message":"error.illegalState","description":"No country code","httpStatus":"BAD_REQUEST","moreInformation":"No country code","httpCode":"400","httpMessage":"Bad Request"} |
| Countries | Country not covered | {"message":"error.illegalState","description":"Country [XX] is not supported yet!","httpStatus":"BAD_REQUEST","moreInformation":"Country [XX] is not supported yet!","httpCode":"400","httpMessage":"Bad Request"} |
| Countries | RegistrationId not matching the country context | {"message":"error.illegalState","description":"Country [XX] does not support the registration id [XX]!","httpStatus":"BAD_REQUEST","httpCode":"400","httpMessage":"Bad Request","moreInformation":"Country [XX] does not support the registration id [XX]!"} |
| Countries | Non existing country code | { "message": "error.illegalState", "description": "Country code [XX] is not a valid country code!","httpStatus": "BAD_REQUEST","moreInformation": "Country code [XX] is not a valid country code!","httpCode": "400","httpMessage": "Bad Request" } |
En savoir plus sur les Quels codes HTTP sont retournés par les APIs Sis Inside ?