Appearance
Errors
Caution – Only the legacy API sends the error code in HTTP errors
When handling errors with connect, only the message attribute is returned for now.
Wallets
The following API errors can be encountered when dealing with wallets.
| Code | Message | Additional information |
|---|---|---|
12001 | Impossible to read Wallet | |
12002 | Impossible to create Wallet | |
12010 | Impossible to update Wallet | |
12011 | Impossible to update Wallet, the wallet is already canceled | |
12012 | eventPayinStartDate format is not valid | |
12013 | eventPayinEndDate format is not valid | |
12014 | eventPayinStartDate cannot be earlier than the creation date of the wallet | |
12015 | eventPayinStartDate can't succeed eventPayinEndDate | |
12016 | eventPayinEndDate cannot be earlier than eventPayinStartDate | |
12018 | Impossible to change eventPayinStartDate when a gift is already offered | |
12020 | Impossible to Cancel Wallet. The wallet does not exist | |
12021 | Impossible to create Wallet image repository | |
12022 | Impossible to create Wallet image file | |
12023 | Impossible to create Wallet, Tarif is not comform | |
12024 | Impossible to create Wallet, Tarif does not exist | |
12025 | Impossible to create Wallet, Alias is not unique | |
12026 | Unable to create Wallet. The unicity of the alias can't be checked. | |
12027 | Impossible to update Wallet, eventPayinEndDate can't be lower than today | |
12028 | Impossible to update Wallet, WalletId is not valid | |
12029 | Impossible to Cancel Wallet, WalletId is not valid | |
12030 | Impossible to Cancel Wallet, The wallet is already in status CANCELLED | |
12031 | Impossible to create Wallet, User Id required | |
12032 | Impossible to create Wallet, User Id not permitted | |
12033 | Impossible to create Wallet, Joint User Id not valid | |
12034 | Impossible to create Wallet, Currency must be EUR | |
12035 | Unable to create the wallet. eventPayinEndDate cannot be earlier than eventPayinStartDate | |
12036 | Impossible to create Wallet, Name is required | |
12037 | Unable to create wallet. The event Payin Start Date is mandatory. | |
12038 | Unable to create wallet. The event Payin End Date is mandatory. | |
12039 | Unable to create wallet. The origin is not correct | |
12040 | Unable to Cancel wallet. The origin is not correct | |
12041 | Unable to Cancel wallet. Balance is not null. | |
12042 | Unable to retrieve a wallet in the Database | |
12043 | No status retrieved for wallet in Database | |
12044 | The status linked to the wallet has no name | |
12045 | The wallet has no user linked impossible to continue | |
12046 | The wallet has no Tariff | |
12047 | The wallet has no Tariff specified for an incoming SCTR | |
12048 | The wallet has no Tariff specified for an incoming SDDR | |
12049 | The walletTypeId is missing | |
12050 | The walletTypeId must be 9 (Electronic Money Wallet), or 10 (Payment Account Wallet), or 13 (Mirror Account) | |
12051 | Impossible to change the type of the wallet due to presence of transactions for this wallet | |
12052 | The walletId is missing | |
12053 | The beneficiaryName is missing | |
12054 | The beneficiaryAddress is missing | |
12055 | The beneficiaryIban is missing | |
12056 | The beneficiaryBic is missing | |
12057 | No status retrieved for wallet in Database | |
12058 | The beneficiaryName is not valid | |
12059 | The beneficiaryAddress is not valid | |
12060 | The beneficiaryIban is not valid | |
12061 | The wallet cannot be closed yet | |
12062 | The wallet is already closed | |
12063 | The wallet have not cards which linked to | |
12064 | Error during block card linked to the wallet | |
12065 | The request must contains at least one of those inputs : walletId, eventAlias, userId, walletTypeId | |
12066 | Impossible to Cancel Wallet, The wallet has pending payin refunds | |
12067 | No wallet retrieved | |
12068 | Impossible to create Wallet, the user is freezed | Blocked users can't have new wallets. |
12069 | Impossible to create Wallet, the user is legal frozen | Users whose assets are frozen can't have new wallets. |
12070 | Impossible to cancel the wallet, technical card wallets cannot be canceled | |
12071 | Impossible to create the wallet, field bic should not be empty when provided | |
12072 | Impossible to create the wallet, the provided bic is not correct | |
12073 | Impossible to create the wallet, the provided bic met too much possible candidate | |
12074 | Impossible to create the wallet, please provide a valid bic | |
12075 | Impossible to create the wallet, invalid payment institution bic | |
12076 | Impossible to create the wallet, the bic provided is not authorized | |
12077 | Impossible to create the wallet, the iban could not be generated |
Anonymous Electronic Money Wallets
Exceeding Electronic Money Wallets limitations or restrictions will produce the following errors.
In Requests
| Context | Endpoint | Code | Message |
|---|---|---|---|
| SDDE | /payins | 14058 | You attempt to create a payin of type SDD Core, The wallet is not of type compte de paiement, impossible to continue |
| Payouts | /payouts | 16027 | Impossible to create Payout due to incoherent KYC level |
| Transfers | /transfers | 120019 | Impossible to create the operation, the total debit exceed the max total debit limit on sliding period |
| Transfers, Payins | /transfers, /payins | 120020 | Impossible to create the operation, the authorization amount exceed the max amount limit |
| Transfers, Payins | /transfers, /payins | 120021 | Impossible to create the operation, the authorization amount added to the account limit exceed the max account amount limit |
| Transfers | /transfers | 120022 | Impossible to create the operation, the transfer creditor user is invalid |
| Transfers | /transfers | 120023 | Impossible to create the operation, the transfer debitor user is invalid |
| Transfers, Payins | /transfers, /payins | 120026 | Impossible to create the operation, the total credit exceed the max total credit limit on sliding period |
In Webhooks
| Context | Webhook | Error | Message (if any) |
|---|---|---|---|
| SDDR | sepa.reject_sddr_core | reject_reason_code=AG01 | |
| SDDR | sepa.reject_sddr_b2b | reject_reason_code=AG01 | |
| SDDR | sepa.return_sddr | reject_reason_code=AG01 | |
| SCTR | sepa.return_sctr | return_reason_code=AG01 | |
| SCTR | sepa.return_sctr | return_reason_code=RR04 | |
| SCTR Inst | sepaSctrInst.reject_sctr_inst | return_reason_code=RR04 | |
| Card Payment | cardtransaction.create | authorizationResponseCode=57 | Electronic Money : transaction not permitted to cardholder |
| Card Payment | cardtransaction.create | authorizationResponseCode=57 | Electronic Money : cumulative amount authorized exceeded |
| Card Payment | cardtransaction.create | authorizationResponseCode=57 | Electronic Money : amount exceeds the authorized amount |
| Card Payment | cardtransaction.create | authorizationResponseCode=57 | Electronic Money : payment is not permitted in this country |
| Card Payment | cardtransaction.create | authorizationResponseCode=57 | Electronic Money : refused due to error |
Balances
| Code | Message |
|---|---|
24000 | No balance corresponds to your search. |
24001 | Exception while attempting to update authorizations |
24002 | Impossible to continue operation. Balance data on wallet were not retrieved |
24003 | walletId is mandatory |
24004 | You must provide at least one argument: walletId or userId |
Virtual IBANs
The following API errors can be encountered when dealing with virtual IBANs.
| Code | Message |
|---|---|
71001 | No Wallet Linked to the Virtual IBAN |
71002 | The wallet linked to the IBAN has no status |
71003 | Wallet linked to the Virtual Iban has a not permitted Status |
71004 | Currency of operation does not match the currency of wallet linked to the virtualIban |
71005 | This transaction type is not supported by the virtual IBAN System |
71006 | Transaction type not specified in virtual Iban Object impossible to check validity of virtual Iban regarding operation |
71007 | Transaction type of operation is not supported by the virtual Iban |
71008 | Impossible to add a new transaction for this virtualIban, number of transactions will be exceeded |
71009 | Impossible to add a new transaction for this virtualIban, max amount will be exceeded |
71010 | Validity date of this virtual Iban is KO |
71011 | The virtual iban with the id provided does not exist |
71012 | Impossible to create an iban |
71013 | The field walletId must be provided |
71014 | The field validFrom is lower than current date |
71015 | The field validTo is lower than date validFrom |
71016 | The field reference has a limit of 255 characters |
71017 | The field tag has a limit of 255 characters |
71018 | The field maxUsage must be higher than 1 |
71019 | The field maxUsage must be higher than the number of transactions made by the virtualIban |
71020 | The field maxAmount must be higher than 1 |
71021 | The field maxAmount must be higher than the cumulated amount |
71022 | The field maxAmount must follow this format: '2.15' |
71023 | The field virtualibanId must be provided |
71024 | The typeId is required |
71025 | The typeId is invalid |
71026 | Unable to create virtual IBAN. Database Error. |
71027 | Wallet linked to the Virtual Iban has a not permitted type |
Transactions
The following API errors can be encountered when dealing with transactions.
| Code | Message |
|---|---|
23000 | Impossible to read Transaction. Database Error. |
23001 | Card transaction already in transaction. |
23003 | The request must contain at least one of these inputs: walletId, transactionId, executionDate, valueDate. |
23004 | createdDateFrom must be a valid YYYY-MM-DD HH:MM:SS date. |
23005 | createdDateTo must be a valid YYYY-MM-DD HH:MM:SS date. |
23006 | createdDateTo cannot be lower than createdDateFrom. |
23007 | transactionTypeId and transactionType do not refer to the same TransactionType. |
23008 | transactionType should be a string. |
23009 | transactionTypeId should be numeric (string or integer). |