Sign in

099ef636a5a1

latestOpenAPI 3.0.12026-08-0660121245.3 KB
Account closure requests

Initiate account closure request

Creates an account closure request for the specified account. See the account closure guide for more information about this process and the associated stages.

post/v1/account_closure_requests

Request body

account_idstring required

ID of the account to be closed.

closure_reason'ACCOUNT_REVOCATION' | 'CUSTOMER_WISH' | 'PARTNER_SERVICE_ACCOUNT_TERMINATED' | 'RELATIONSHIP_TERMINATION' | 'COMPLIANCE_IMMEDIATE_PARTNER' required

List of possible reasons for an account closure request initiated by a partner.

Example request

{
  "account_id": "5526853938474f3e92b22a03ea57a544cacc",
  "closure_reason": "CUSTOMER_WISH"
}

Response

The operation was successful (idempotency).

idstring

ID of the account closure request.

closure_reason'ACCOUNT_REVOCATION' | 'ACCOUNT_REVOCATION_INTERNAL' | 'COMPLIANCE_IMMEDIATE_INTERNAL' | 'COMPLIANCE_IMMEDIATE_PARTNER' | 'COMPLIANCE_ORDINARY_INTERNAL' | 'CUSTOMER_WISH' | 'CUSTOMER_WISH_INTERNAL' | 'DUNNING_DECOUPLED_CARD_INTERNAL' | 'FATCA_STATUS_INELIGIBLE_IMMEDIATE' | 'FATCA_STATUS_INELIGIBLE_ORDINARY' | 'INSOLVENCY_IMMEDIATE_INTERNAL' | 'INSOLVENCY_ORDINARY_INTERNAL' | 'KYC_ORDINARY_INTERNAL' | 'PARTNER_SERVICE_ACCOUNT_TERMINATED' | 'RELATIONSHIP_TERMINATION' | 'RELATIONSHIP_TERMINATION_INTERNAL' | 'SEIZURES_ORDINARY_INTERNAL' | 'TAX_ID_CHANGE_ORDINARY' | 'TECHNICAL_IMMEDIATE_INTERNAL' | 'TERMS_AND_CONDITIONS_BREACH_IMMEDIATE' | 'TERMS_AND_CONDITIONS_BREACH_ORDINARY' | 'WRONG_ACCOUNT_TYPE'

List of possible reasons for an account closure request initiated by Solaris.

status'INITIATED' | 'CONFIRMED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'REVOKED'

Possible status values for an account closure request.

account_idstring

ID of the account to be closed.

technical_closure_datestring date

The date when the account was removed from the Solaris system.

legal_closure_datestring date

The date when the contractual relationship underlying the product/account ends.

payout_allowedfalse | true

payout_allowed is deciding whether the funds can be paid out in the automated process, but it also serves as information for the Partner on whether or not the Customer is allowed to pay out funds from the account.

updated_atstring date-time

Updated date and time

Example response

{
  "id": "f8d7fbbd587047a0aa449ce69d2d6c08acrq",
  "closure_reason": "COMPLIANCE_IMMEDIATE_INTERNAL",
  "status": "IN_PROGRESS",
  "account_id": "5526853938474f3e92b22a03ea57a544cacc",
  "technical_closure_date": "2021-10-11",
  "legal_closure_date": "2021-10-11",
  "failure_reason": {
    "code": "negative_balance",
    "detail": "Account balance is negative, can't perform technical closure."
  },
  "updated_at": "2021-12-22T15:05:33.634Z"
}