NEnestechops
ledger-card accounts

Terminate a card account.

Changed on

Terminates the card on the provider and sweeps any residual dedicated-account balance back to the business's MAIN account.

post/ledger/card-accounts/{cardAccountId}/terminate

Request

Path parameters

cardAccountIdstring uuid required

The unique card account ID

Response

Card account terminated successfully

idstring uuid required

Unique card account ID.

accountIdstring uuid required

The MAIN account this card is funded from.

currencystring required
status'PENDING_KYC' | 'PENDING_PROVISIONING' | 'ACTIVE' | 'FROZEN' | 'TERMINATED' | 'KYC_REJECTED' | 'CREATION_FAILED' required

Lifecycle of a card account. PENDING_KYC and PENDING_PROVISIONING are transient - a card only starts moving money once it reaches ACTIVE. KYC_REJECTED and CREATION_FAILED are terminal with no funds ever moved (the dedicated ledger account is only created once KYC is approved).

balancenumber required

The card's live spendable balance.

failureReasonstring

Populated when status is KYC_REJECTED or CREATION_FAILED.

createdDatestring date-time required

Example response

{
  "currency": "USD"
}

Changes

  • 5b7b2c163546Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 1805362fe220Revision changes
    • info

      endpoint added