# Generate new Destination Account Card Form and remove old one.

**POST** `/destination-accounts/{accountId}/card-forms`

Base URL: `https://api.uat.triple-a.io/api/fiat-payout/v1`

When new link is generated:
  if there's no card added yet, nothing happen
  if there's a card added but not-used, that card will be invalidated
  if there's a card added but in-used, that card is still used in pending transfers and new card will be used for future transfers

## Authorization

- oauth2 (http, bearer)

## Path parameters

- `accountId` (string, required)

## Responses

### 200

Created

- `id` (string)
- `status` (string)
- `reason` (string)
- `reason_code` (string)
- `created_at` (string<date>)
- `deleted_at` (string<date>)
- `expires_at` (string<date>)
- `used_at` (string<date>)
- `submitted_at` (string<date>)
- `charged_at` (string<date>)
- `hosted_url` (string<uri>)
  The link to the card adding form (front end).
  Card form is only valid for a certain time. To generate the new link, please call `POST /destination-accounts/{accountId}/card_form`.
  Please checkout the note for that api

Example:

```json
{
  "id": "string",
  "status": "string",
  "reason": "string",
  "reason_code": "string",
  "created_at": "2024-01-01",
  "deleted_at": "2024-01-01",
  "expires_at": "2024-01-01",
  "used_at": "2024-01-01",
  "submitted_at": "2024-01-01",
  "charged_at": "2024-01-01",
  "hosted_url": "string"
}
```

### 400

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```

### 404

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```

### 500

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```