Create debit card application

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

curl --location 'https://card-api.sandbox.tuumplatform.com/api/v3/applications/create' \
--header 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHBpcnlEVGltZSI6IjIwMjMtMDYtMjlUMTQ6MTg6NDQiLCJyb2xlcyI6WyJBRE1JTiJdLCJuYW1lIjoiSm9obiBPZmZpY2VyIiwiZW1wbG95ZWVJZCI6IjEiLCJ0ZW5hbnRDb2RlIjoiTUIiLCJleHAiOjE2ODgwNDgzMjR9.fdNWur6wqZQRM9it9sLBTSQ96sBWSberE1IrjF3LCVM' \
--header 'x-channel-code: system' \
--header 'Content-Type: application/json' \
--data '{
  "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"
}'

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.