Account Status

When an Account is created, the default status is inactive restricting any activity outside of changing the status; you can set this to active at creation stage using the Create Account API.

In most cases, during the Account Lifecycle, the status will not require any changes; however there may be times when the status is to be updated. The following status values can apply:

  • inactive: Default value which is applied by CLOWD9. Once the Account status has been changed from inactive, this can never be reverted to this status. All activity is restricted under this status and restricts all activity to the Account such as:
    • Balance updates
    • Use of any card_id and or dpan_ids that the Customer may have i.e. authorizations will be declined
  • active: The Account can set to active during the create stage or at a later date using the Set Account Status API. All activity will be permitted
  • administrative: A temporary block to restrict all activity on the Account pending the outcome of any investigation. Post investigations the Account should be returned to active, fraud or closed
  • fraud: A permanent status which is to be used where the Account and / or associated payment devices have had fraudulent activity. A new Account will need to be created
  • closed: In the event of the Customer requiring to close their Account, once remaining funds have been removed from the Account balance and all relevant actions completed in line with your procedures, the Account should be set to closed

CLOWD9 will return any requests where the new status is equal to the existing status, for example changing from active to active.

Specifications

Request


JSON PATHDescriptionExampleFormatRequired
account_idIdentifier associated to the Account3d0229b5-8330-4c62-be60-d8a5ba2f605dUUIDYes
account_statusDefault is inactive and until set to active, all Account activity will be restrictedactivestringYes

Succesful Response


JSON PATHDescriptionExampleFormat
account_idIdentifier associated to the Account3d0229b5-8330-4c62-be60-d8a5ba2f605dUUID
previous_account_statusPrevious status of the Accountinactivestring
new_account_statusNew status of the Accountactivestring
trace_idThe Identifier associated with the API663bd8a4-6dfa-4ec2-b269-fedc0743f1ddUUID