Close Account

Last changes: 04-15-2020

The API request 1.73 Close Account will set the status of the account to "CLOSED" and no further interaction with the account will be possible following closure.

In the example below, we close the account associated with the External Account Reference KDNR0001.

Additionally, state reason for the closing the account under the parameter “closingReason”.

Close Account Request

Path:

POST {Base URL}/account/KDNR0001/close

Header:

Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: H4sIAAAAAAA{partial omission for brevity}EAN2bJ/6l2XX+A5kJqdP+MwAA

{
    "partnerReference": "DEV-SVR001-DE_CUSTID-VW7T78J33B_CARTID-32RKRCWCR2_CY46K6X9VV",
    "programCode": "COMPANYDE",
    "accnoType": "00",
    "closingReason": "Account holder requesting closure of account.",
    "localDate": "2018-11-06",
    "localTime": "104915"
}

Close Account Response

Status Code:

200 (OK)

Header:

Content-Type: application/json
Accept-Language: en-US

{
    "accno": "KDNR0001",
    "statusCode": "CLOSED",
    "dateClosed": "2018-11-06",
    "programCode": "COMPANYDE",
    "partnerReference": "DEV-SVR001-DE_CUSTID-VW7T78J33B_CARTID-32RKRCWCR2_CY46K6X9VV",
    "localDate": "2018-11-06",
    "localTime": "104915",
    "sysDate": "2018-11-06",
    "sysTime": "094915",
    "responseCode": "0000",
    "responseDescription": "Successful execution"
}

The response includes the account status under the return parameter “statusCode”, which at this point should be set to “CLOSED”. The "responseCode" 0000 and the “responseDescription” indicate that the account has been successfully closed.