Create debit card application

Here, the application specifies the product details that apply to the card, such as the price list code, usage group code, and limit group code. This is useful if you want to create a card with a configuration, such as a price list, that is permitted for the selected card product but is not the default.

Use case

We will create a new debit card application for a private person using the debit card product.

Use case data	API parameters with values
Card application type	"applicationTypeCode": "NEW_CARD"
Product code	"productCode": "DEBIT2023"
Price list code	"priceListCode": "DEBIT2023"
Account owner details	"accountOwner": { "personId": "ID-3382", "accountOwnerTypeCode": "PRIVATE" }
Cardholder details	"cardholder": { "personId": "ID-3382", "firstName": "Andy", "lastName": "Smith" }
Shipping address details	"shippingAddress": { "postCode": "52413", "countryCode": "EE", "city": "Tallinn", "county": "Harju", "streetAddress": "Viru street 1" }, "shippingPhone": { "phoneCountryCode": "+372", "phoneNumber": "53567421" }
Card usage and limit groups	"usageGroupName": "ALL_ALLOWED", "limitGroupName": "DEBIT2023_LIMIT_GROUP"

Sample API call

To create the card application, use the following endpoint:

https://card-api.sandbox.tuumplatform.com/api/v3/applications/create

Learn more about the create card application endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

JSON

{
  "applicationTypeCode": "NEW_CARD",
  "productCode": "DEBIT2023",
  "priceListCode": "DEBIT2023",
  "issuingCountryCode": "EE",
  "tenantCode": "MB",
  "accountOwner": {
    "personId": "ID-3382",
    "accountOwnerTypeCode": "PRIVATE"
  },
  "cardholder": {
    "personId": "ID-3382",
    "firstName": "Andy",
    "lastName": "Smith"
  },
  "shippingAddress": {
    "postCode": "52413",
    "countryCode": "EE",
    "city": "Tallinn",
    "county": "Harju",
    "streetAddress": "Viru street 1"
  },
  "shippingPhone": {
    "phoneCountryCode": "+372",
    "phoneNumber": "53567421"
  },
  "usageGroupName": "ALL_ALLOWED",
  "limitGroupName": "DEBIT2023_LIMIT_GROUP"
}

cURL

Sample response

Below you will find the response to the sample request:

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "applicationId": "C001664282467",
        "applicationTypeCode": "NEW_CARD",
        "statusCode": "COMPLETED",
        "productCode": "DEBIT2023",
        "cardId": "C001664282448",
        "mainCardId": null,
        "currencyCode": "EUR",
        "priceListCode": "DEBIT2023",
        "issuingCountryCode": "EE",
        "designCode": "XX",
        "areLimitsShared": null,
        "applicationDate": "2023-06-29",
        "orderPlastic": true,
        "productScheme": "MASTERCARD",
        "productClass": "DEBIT",
        "pinDeliveryMethod": "DIGIPIN",
        "servicingAccount": null,
        "accountOwner": {
            "personId": "ID-3382",
            "accountOwnerTypeCode": null
        },
        "cardholder": {
            "personId": "ID-3382",
            "firstName": "Andy",
            "lastName": "Smith",
            "companyName": null
        },
        "shippingAddress": {
            "postCode": "52413",
            "countryCode": "EE",
            "city": "Tallinn",
            "county": "Harju",
            "streetAddress": "Viru street 1"
        },
        "shippingPhone": {
            "phoneCountryCode": "+372",
            "phoneNumber": "53567421"
        },
        "creditConditions": null,
        "usageGroupName": "ALL_ALLOWED",
        "limitGroupName": "DEBIT2023_LIMIT_GROUP",
        "expressCard": false
    }
}

Result

The card application has been created with the COMPLETED status and an application ID in the response. The card is successfully assigned to the person. If the application is in the WAITING status, you can manually accept it using the application ID.

Similarly, you can create applications for supplementary cards and credit cards.