Skip to main content

Account closure

You can ask for an account closure following your customer request or if your customer doesn't, for example, follow your service rules. In the first case the effective closure will take 30 days, in the second the closure will take 60 days.

note

Please note that an account closure can only be asked on a null balance account (ie : the account owner might payout the remaining balance for its closing request to be agreed)

note

To allow sandbox testing, the closing delay time in production is immediate. As a consequence, the expectedCloseDate is set to the date of the closure request.


To achieve "Closed" status, the following prerequisites must be met:

  • All operations must have a final status (i.e., all card authorizations are either completed or expired).
  • The account balance must be €0, both in terms of authorization balance and accounting balance.
Important

A request to close an account is irreversible.


State diagram



Flowchart


Account status PendingClosure

To initiate an account closure, the balance must be empty. If this is not the case, it is necessary to make a call beforehand:

  • add a beneficiary
  • SCT OUT

As soon as the account statut is PendingClosure, the account is frozen




Transaction accepted or refused during the PendingClosure period


Type of transactionAcceptation
SCT OUTRefused
SCT INRefused
Recall SCT OUTAccepted
Recall SCT INRefused
IP INRefused
IP OUTRefused
Recall IP INRefused
Recall IP OUTRefused
SDD INRefused
SDD OUTRefused
Top-upRefused
Refund Top-upRefused
Top-up contestationAccepted
Card out authorisationRefused
Card out settlementAccepted
Card out offlineAccepted
Card in (card out refund)Accepted
Card out contestationAccepted
P2PRefused
DebtAccepted
Corrective operation (internal XPO)Accepted

note

If charges are to be levied, it is important to do so before the account closure request



Account closed

Case: account balance is 0 or beneficiaryAccountId available

30 / 60 days later, the account automatically changes from PendingClosure to Closed. If the holder's balance has been credited during this period, all funds are automatically sent to the beneficiaryAccountId indicated in the request made for the closure-request.



Case: missing beneficiaryAccountId and Non-Zero Balance During Account Closure Request

After the 30/60 days, when the closure is requested, but the beneficiaryAccountId is either not available or not provided, and the account still has a non-zero balance, it becomes impossible to execute the SCT OUT.

The affected account IDs are included in a specialized report listing all accounts that cannot be closed due to missing IBAN information.

Then next steps are manual:

  • A Zendesk ticket is created and sent to you, containing the list of accounts requiring the IBAN.
  • As a partner, you contact your end users to request the necessary IBAN information.
  • Once retrieved, you update the Zendesk ticket with the required IBANs.
  • The banking team then processes a corrective SCT to transfer the remaining balance.
note

Corrective SCT operations are only available for Xpollens teams.



Transaction accepted or refused as soon as the account is closed


Type of transactionAcceptation
SCT OUTRefused
SCT INRefused
Recall SCT OUTRefused
Recall SCT INRefused
IP INRefused
IP OUTRefused
Recall IP INRefused
Recall IP OUTRefused
SDD INRefused
SDD OUTRefused
Top-upRefused
Refund Top-upRefused
Top-up contestationCharged to the Xpollens's holding account
Card out authorisationRefused
Late card out settlementCharged to the Xpollens's holding account
Card out offlineCharged to the Xpollens's holding account
Card in (card out refund)Charged to the Xpollens's holding account
Card out contestationCharged to the Xpollens's holding account
P2PRefused
DebtCharged to the Xpollens's outstanding account
Corrective operation (internal XPO)Accepted

note

Operations credited in the Xpollens's outstanding account are refunded manually to the enduser.



Suspended operations

In the event of receiving a credit or debit transaction on a closed account, the transaction is created with a "Suspended" status. The end user's account is not debited or credited; instead, the partner's suspense account is impacted.




Technical items

Closure request

POST /api/v3.0/accounts/{accountId}/closure-request

Important Note
  • if the end user is a prospect, with no funds in their bank account: you can use the API without the beneficiaryAccountId .

  • if the enduser's account is validated or has funds, the request must include the beneficiaryAccountId . Without this, the account can never be closed, as the account balance will never be €0.


In the case that the external account used to receive the funds is frozen / blocked / closed / ..., the funds cannot be returned. In this case, a manual intervention by Xpollens will be necessary to return the accounts to another account.

Best pratices

Collect debts before closing the account

Commission cannot be taken out once the account has been closed. It is therefore essential to collect debts before closing the account.

Remove the charges taken from these accounts in the batches

Commission cannot be taken out once the account has been closed. It is therefore essential that accounts in ClosureRequested, Pendingclosure and Closed status are removed from the fee-taking batches.



FAQ

FAQ1: What should your application do when a customer requests account closure?

When a customer initiates an account closure request, your application should immediately restrict access to the following functionalities:

  • SEPA Transfers: Block both standard SEPA Credit Transfers (SCT) and Instant Payments (IP).
  • Card Creation: Disable the ability to request or issue new cards
  • Mandate & SDD Creation: Prevent the creation of new mandates and SEPA Direct Debits (SDD).

If a request is made to any of these functionalities after the account closure request, a 40x error will be returned.


FAQ2: When is the latest account statement available?

The last account statement is generated in the first few days after the account status is changed to Closed.