Create supplementary debit card application

Here you will learn how to create a card application for a supplementary debit card. A supplementary card is created using the same parameters as the main card, unless specified otherwise.

Use case

In this example, we will demonstrate how to create a card application for a supplementary debit card.

Use case data	API parameters with values
Card application type	"applicationTypeCode": "SUPPLEMENTARY_CARD"
Account owner details	"accountOwner": { "personId": "ID-3438", "accountOwnerTypeCode": "PRIVATE" }
Cardholder details	"cardholder": { "personId": "ID-30496", "firstName": "Isabel", "lastName": "Lacoste" }
Supplementary card will share card limits with main card. To assign a separate limit to the supplementary card, set "areLimitsShared": false.	"areLimitsShared": true
Reference to main card.	"mainCardId": "C001664282650"

Sample API call

To create a new supplementary 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": "SUPPLEMENTARY_CARD",
  "accountOwner": {
    "personId": "ID-3438",
    "accountOwnerTypeCode": "PRIVATE"
  },
  "cardholder": {
    "personId": "ID-30496",
    "firstName": "Isabell",
    "lastName": "Lacoste"
  },
  "areLimitsShared": true,
  "mainCardId": "C001664282650"
}

cURL

curl -X 'POST' \
  'https://card-api.sandbox.tuumplatform.com/api/v3/applications/create' \
  -H 'accept: */*' \
  -H 'x-tenant-code: MB' \
  -H 'Accept-Language: en' \
  -H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjc3JmVG9rZW4iOiIxMTc2NDMzNzE2IiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTA3LTAyVDExOjIzOjA2Iiwicm9sZXMiOlsiQURNSU4iXSwibmFtZSI6IkNhcmQgVXNlciIsImVtcGxveWVlSWQiOiJJRC0xMTAxIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwIjoxNzUxNDU1Mzg2fQ.jTQk8jVLVENZcoK3dICcWVpk_9kELHeJ1xiO6JEJtBQ' \
  -H 'Content-Type: application/json' \
  -d '{
  "applicationTypeCode": "SUPPLEMENTARY_CARD",
  "accountOwner": {
    "personId": "ID-3438",
    "accountOwnerTypeCode": "PRIVATE"
  },
  "cardholder": {
    "personId": "ID-30496",
    "firstName": "Isabell",
    "lastName": "Lacoste"
  },
  "areLimitsShared": true,
  "mainCardId": "C001664282650"
}'

Sample response

Below you will find the response to the sample request:

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "applicationId": "C001664282674",
        "applicationTypeCode": "SUPPLEMENTARY_CARD",
        "statusCode": "COMPLETED",
        "productCode": "INTERNAL_ACCOUNT_VIRTUAL_M",
        "cardId": "C001664282674",
        "mainCardId": "C001664282650",
        "currencyCode": "EUR",
        "priceListCode": "DEBIT_CARD_2",
        "issuingCountryCode": "EE",
        "designCode": "11",
        "areLimitsShared": true,
        "applicationDate": "2025-10-08",
        "isExpressCard": false,
        "orderPlastic": false,
        "productScheme": "MASTERCARD",
        "productClass": "DEBIT",
        "pinDeliveryMethod": "DIGIPIN",
        "servicingAccount": null,
        "accountOwner": {
            "personId": "ID-3438",
            "accountOwnerTypeCode": null
        },
        "cardholder": {
            "personId": "ID-30496",
            "firstName": "Isabell",
            "lastName": "Lacoste",
            "companyName": null
        },
        "shippingAddress": null,
        "shippingPhone": null,
        "creditConditions": null,
        "usageGroupName": null,
        "limitGroupName": null,
        "mccGroupName": null,
        "xpaysAllowed": null
    }
}

Result

The API call returns the full set of card application data, including parameters automatically generated by the Tuum system, as shown below:

Parameter and value	Explanation
"applicationId": "C001664282674"	A new supplementary card application with the ID C001664282674 has been registered in the system.
"statusCode": "COMPLETED"	The card application has been accepted automatically. Note: Whether a card application requires an acceptance step is determined by the configuration of the associated card product.
"cardId": "C001664282674"	New card with the ID C001664282674 has been issued.