Create debit card application

PreviousActivate card product NextCreate credit product

Last updated 12 months ago

Was this helpful?

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

Product code

Price list code

Account owner details

Cardholder details

Shipping address details

Card usage and limit groups

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:

{
  "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 --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.