Create Card with DDA

Creates a physical or virtual card for customers with a pre-existing DDA (Demand Deposit Account). This endpoint is designed for customers who do not use trade wallets. The card creation fee is automatically deducted from the customer's DDA account balance. The customer must have been onboarded with bCreateDDA = true and must have sufficient funds in their DDA account before calling this endpoint.

• Endpoint: /api/v1/customer/cards/create-with-dda

• Method: POST

Request Body

{
  "customersId": 16533,                     // required, number, the managee's customer ID who has bCreateDDA enabled
  "cardProgramID": 1000,                    // required, number, card program ID (e.g., 1000)
  "cardType": "Physical",                   // optional, string, possible: "Physical" (default), "Virtual"
  "shippingMethod": "Standard",             // required, string, possible: "Standard", "Express"
  "cardReferenceId": "CARD-DDA-001",       // optional, string, custom reference ID for tracking
  "shippingAddress": {
    "shippingAddressLine1": "House Name",   // required, string, street address or building name
    "shippingAddressLine2": "Apartment 5B", // optional, string, apartment, suite, or unit number
    "shippingAddressCity": "Miami",         // required, string, city name
    "shippingAddressState": "FL",           // required, string, US state abbreviation (e.g., "FL", "NY", "CA")
    "shippingAddressPostcode": "12345-1234",// required, string, ZIP code in format: 12345 or 12345-1234
    "shippingAddressCountry": "USA"         // required, string, currently only "USA" is supported
  },
  // Not required if customer was onboarded within last 6 months
  "businessReviewDetails": {
    "legalEntityName": "ABC Corporation",              // required, string, legal business name as registered
    "doingBusinessAs": "ABC Corp",                     // optional, string, DBA name if different from legal name
    "entityType": "Corporation",                       // required, string, possible: "Corporation", "LLC", "Partnership", "Sole Proprietorship"
    "registeredAddressStreet": "123 Business Plaza",   // required, string, registered business address line 1
    "registeredAddressNumber": "Suite 500",            // optional, string, registered address line 2
    "registeredAddressCity": "Miami",                  // required, string, registered address city
    "registeredAddressState": "FL",                    // required, string, registered address state abbreviation
    "registeredAddressPostcode": "33101-5678",         // required, string, registered address ZIP code
    "registeredAddressCountry": "USA",                 // required, string, registered address country
    "operatingAddressStreet": "456 Operations Drive",  // optional*, string, operating address line 1 (required if any operating field provided)
    "operatingAddressNumber": "Building A",            // optional, string, operating address line 2
    "operatingAddressCity": "Miami",                   // optional*, string, operating address city (required if operatingAddressStreet provided)
    "operatingAddressState": "FL",                     // optional*, string, operating address state (required if operatingAddressStreet provided)
    "operatingAddressPostcode": "33102-1234",          // optional*, string, operating address ZIP code (required if operatingAddressStreet provided)
    "operatingAddressCountry": "USA",                  // optional*, string, operating address country (required if operatingAddressStreet provided)
    "businessActivities": ["Financial Services", "Technology"],    // required, array of strings, at least one business activity
    "regionOfOperations": ["North America", "Europe"], // required, array of strings, at least one region
    "fundsReceivedFromUSA": true,                      // required, boolean, true if business receives funds from USA
    "fundsSentToUSA": true,                            // required, boolean, true if business sends funds to USA
    "hasOwnershipStructureChangedSinceOnboarding": false,  // required, boolean, must be false (cannot be true)
    "sourceOfFunds": ["Business Revenue", "Investment"], // required, array of strings, at least one source
    "authorizedCapital": 500000,                       // required, number, authorized capital in USD, must be > 0
    "comingYearTurnOverPlanned": 1000000               // required, number, projected annual turnover in USD, must be > 0
  },
  "personalReviewDetails": {
    "sourceOfFunds": ["Salary", "Investment Income"],  // required, array of strings, at least one source, possible: "Salary", "Investment Income", "Business Revenue", "Inheritance", "Property Sale", "Loan", "Other"
    "estimatedGrossAnnualIncome": 75000,               // required, number, annual income in USD, must be > 0
    "estimatedNetWorth": 150000,                       // required, number, net worth in USD, must be > 0
    "activelyEmployed": true,                          // required, boolean, true if currently employed
    "employedCompanyName": "QWE Solutions",            // optional*, string, company name (required if activelyEmployed is true)
    "employedJobTitle": "Team Lead"                    // optional*, string, job title (required if activelyEmployed is true)
  }
}

Response Body

{
    "id": 1927,
    "details": {
        "customersId": 16556,
        "customersReference": "CST16556",
        "card": {
            "id": 1927,
            "currency": "USD",
            "cardNumber": "0xE38oOnwhzFuHYthUiP/NqrPpAh6K2Kvv55mNYlQqE=",
            "totalBalance": 0.0,
            "availableBalance": 0.0,
            "pendingBalance": 0.0,
            "bDeactivated": true
        }
    },
    "status": "1",
    "errors": []
}