Close a Connected Account

Closes an existing connected account. Closing is a synchronous operation—on success the account transitions to CLOSED and the closed account details are returned. An account cannot be closed while it has outstanding obligations or a non-zero balance.
Request Parameters
idstring
required
Unique merchant identifier assigned by WorldFirst. Identifies the connected account to close.
Response Parameters
resultResult
API call result. See Result.
idstring
Unique merchant identifier assigned by WorldFirst.
referenceAccountIdstring
Integrator-side unique merchant identifier, echoed from account creation.
statusstring
Account close result. Because closing is synchronous, a successful call always returns CLOSED.

Valid Values:

CLOSED — The account has been closed.
registrationRegionstring
Country or region where the business is registered, following the ISO 3166 standard. See Data Types.
registrationLegalNamestring
Registered legal name of the business.
contactContact
Contact information for the account.
Show child parametersShow child parameters
agreementsAgreements
Terms and authorization settings confirmed for the account.
Show child parametersShow child parameters
createdAtdatetime
Account creation time, in ISO 8601 extended format.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccess.N/A
PARAM_ILLEGALFIllegal parameters. Refer to the API documentation to verify the request header and parameters, then retry.Check the request header and `id` parameter, then retry.
ACCOUNT_CANNOT_CLOSEFThe account cannot be closed due to outstanding obligations or non-zero balance.Settle all obligations and ensure the account balance is zero before closing.
ACCOUNT_NOT_EXISTFaccount does not exist.Verify `id` matches an existing connected account.
ACCOUNT_STATUS_INVALIDFcannot close account with REJECT or FAILED statusConfirm the account `status` is closable (not `REJECT` or `FAILED`).
UNKNOWN_EXCEPTIONUThe API call is failed, which is caused by unknown reasons.Retry later; if the problem persists, contact support.
Definition
POST /api/open/v1/accounts/close
Request
{
"id": "2088000000000001"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultStatus": "S",
  "resultMessage": "success"
},
"id": "2088000000000001",
"referenceAccountId": "PARTNER_MERCHANT_001",
"status": "CLOSED",
"registrationRegion": "HK",
"registrationLegalName": "EXAMPLE COMPANY LTD",
"contact": {
  "contactEmail": "contact@example.com"
},
"agreements": {
  "agreedToTermsAndConditions": true,
  "agreedToDataUsage": true,
  "accessType": "FULL_ACCESS"
},
"createdAt": "2026-08-08T08:30:00Z"
}