# Create Card

## Create Customer Card

The Create Card endpoint is used to issue a new card to a customer's account. The user must specify the customer's account ID, the currency for the card, and various compliance-related fields such as customer subtype, business activity, occupation, and source of funds. With this information, a new card can be created and linked to the customer's account. Once the card is issued, it's initially suppressed (deactivated) until it's activated by the customer or manager. \
This endpoint supports customers both **with and without trade wallets**. It can create **physical or virtual cards** for customers with an existing **DDA (Demand Deposit Account)**. If a DDA does not exist for the card, the endpoint will automatically create one as part of the card issuance process.

* **Endpoint:** `/api/v1/customer/cards/create`
* **Method:** `POST`
* **Request Format:** application/json
* **Header Parameter**
  * otp : **required**

#### Request Body

```json
{
  "customersId": 14387,                     // required, number, e.g., 1001, 14387
  "currency": "USD",                        // required, string, possible: "USD"
  "cardReferenceId": "CARD-REF-001",       // required, string, can be any identifier
  "shippingMethod": "Standard",             // required, string, possible: "Standard", "Express"
  "cardProgramID": 1002,                    // required, number, must match an existing program ID
  "cardType": "Physical",                  //Physical OR Virtual
  "shippingAddress": {
    "shippingAddressLine1": "Suite 500",    // required, string, street or suite number
    "shippingAddressCity": "New York",      // required, string, valid city name
    "shippingAddressState": "Texas",        // required, string, state name or abbreviation
    "shippingAddressPostcode": "55050",     // required, string, postal/ZIP code
    "shippingAddressCountry": "USA"         // required, string, ISO country code or name
  },
  // Only required for customers older than 6 months
  "businessReviewDetails": {
    "legalEntityName": "Acme Corporation",              // required, string
    "doingBusinessAs": "Acme Co",                       // required, string
    "entityType": "LLC",                                // required, string, possible: "LLC", "Corporation", "Partnership", "Sole Proprietor"
    "registeredAddressStreet": "123 Main St",           // required, string
    "registeredAddressNumber": "10",                    // optional, string
    "registeredAddressCity": "Austin",                  // required, string
    "registeredAddressState": "TX",                     // required, string
    "registeredAddressPostcode": "73301",               // required, string
    "registeredAddressCountry": "USA",                  // required, string
    "operatingAddressStreet": "500 Market St",          // optional*, string, required if any operating field provided
    "operatingAddressNumber": "Suite 2",                // optional, string
    "operatingAddressCity": "Dallas",                   // optional*, string
    "operatingAddressState": "TX",                      // optional*, string
    "operatingAddressPostcode": "75001",                // optional*, string
    "operatingAddressCountry": "USA",                   // optional*, string
    "businessActivities": ["Retail", "E-commerce"],    // required, array of strings, at least one
    "regionOfOperations": ["USA", "EU"],               // required, array of strings, at least one
    "fundsReceivedFromUSA": true,                       // required, boolean, true/false
    "fundsSentToUSA": false,                            // required, boolean, true/false
    "hasOwnershipStructureChangedSinceOnboarding": false,                                                        // required, boolean, cannot be TRUE
    "sourceOfFunds": ["Business Revenue", "Investments"],  // required, array of strings, at least one
    "authorizedCapital": 100000,                        // required, number, must be > 0
    "comingYearTurnOverPlanned": 500000                 // required, number, must be > 0
  },
  "personalReviewDetails": {
    "sourceOfFunds": ["Salary", "Investments"],       // required, array of strings, at least one
    "estimatedGrossAnnualIncome": 90000,              // required, number, must be > 0
    "estimatedNetWorth": 250000,                      // required, number, must be > 0
    "activelyEmployed": true,                          // required, boolean
    "employedCompanyName": "Global Tech Inc",        // required, string
    "employedJobTitle": "Software Engineer"          // required, string
  }
}


```

#### Response Body

```json
{
  "id": 1359,
  "details": {
    "customersId": 14387,
    "customersReference": "card-ref-1",
    "card": {
      "id": 1359,
      "currency": "USD",
      "cardNumber":"9aUb61b4b0EDk92pD7SCOg==",
      "totalBalance": 0,
      "availableBalance": 0,
      "pendingBalance": 0,
      "bDeactivated": true
    }
  },
  "status": "1",
  "errors": []
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://customer-api-docs.ibanera.com/api-endpoints/cards/create-card.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.