Appearance
Are you an LLM? You can read better optimized documentation at /guide/cards/introduction.md for this page in Markdown format
Introduction
Treezor allows you to issue both Physical and Virtual Cards. This section focuses on Card creation and management.
Before starting to issue Cards, you must have a Card Program set up with Treezor.
Information – Card Top-up feature also available
If you're looking to receive card payments to credit a Wallet, see the Card Acquiring section of the documentation.
Card Program
Your Card Program defines the design and configuration of the issued Cards. Your Welcome Pack provided by Treezor contains all the forms to fill in.
Card Programs require assistance from Treezor teams. Contact your Treezor:
- Account Manager AM to define the design your cards.
- Implementation Manager IM to define configuration and customization options.
Once your Card Program is set up, Treezor will give you your cardPrint
. This value is the unique identifier of you Card Program and is required to create Cards.
Card Design AM
You can design both your cards and their shipping packaging.
Your Welcome Pack contains forms and templates for Physical Cards and Virtual Cards design, along with resources to design your cards while abiding by:
- The guidelines provided by the schemes (e.g., Mastercard, Visa, etc.).
- The predefined formats from the card printing third-party.
Card Product & Customization options IM
Your Card Product defines options such as Permissions Group and default limits for the Cards you issue.
You can also add logos, customized text, and specify packaging and card design on a per-Card basis. See the Customization article for more information.
Key attributes
Below are some of the most important Card attributes.
Attribute | Type | Description |
---|---|---|
isLive | integer | The activation status of the Card. Cards are issued as inactive and are activated using the dedicated request.
|
statusCode | integer | The current Card status such as active, stolen, temporarily or permanently blocked. |
pinTryExceeds | integer | Indicates if the PIN try limit has been exceeded (when set to 1 , the PIN is blocked). |
cardDesign | string | The Card Print Id, the design that is/will be printed on the Card. |
optionAtm | integer | The ability to make withdrawals at ATM. |
optionForeign | integer | The ability to use the Card outside the user's country. |
optionOnline | integer | The ability to use the Card for online Payments. |
optionNfc | integer | The ability to use the Card for contactless payment. |
embossedName | string | The cardholder's name, as embossed or etched on the Card. |
maskedPan | string | The PAN with the middle numbers redacted for safety. |
publicToken | string | 9-character long string printed on the Card. It can be used to activate a card. |
API – API Reference available
For a complete list of Card attributes, check the Cards section of the API Reference.
Card Status (statusCode
)
Statuses are defined in the statusCode
attribute of a Card.
Code | Plaintext value | Description | Lock type |
---|---|---|---|
0 | UNLOCK | The card is unlocked and can be used (if no other options or limits prevent it). | N/A |
1 | LOCK | The card is locked and cannot be used. | Reversible |
2 | LOST | The card is lost and cannot be used. | Permanent |
3 | STOLEN | The card is stolen and cannot be used. | Permanent |
4 | DESTROYED | The card is terminated and cannot be used. | Permanent |
5 | LOCK_INTERNAL | The card is locked by Treezor and cannot be used, only Treezor is able to unlock it. | Reversible |
6 | EXPIRED | Automatically set value indicating the card has expired. The card was either renewed or the expiry date passed. Treezor sends the following webhooks:
| Permanent |
7 | CUSTOM_LOCK | Secondary lock; the card is locked and cannot be used. This is the same mechanism as LOCK , providing you more flexibility to manage cards (e.g., reporting reasons, preventing cardholders to unlock the card themselves). | Reversible |
Card object
json
{
"cardId": 0,
"userId": 0,
"walletId": 0,
"walletCardtransactionId": 0,
"mccRestrictionGroupId": 0,
"merchantRestrictionGroupId": 0,
"countryRestrictionGroupId": 0,
"publicToken": "string",
"cardTag": "string",
"statusCode": "UNLOCK",
"isLive": 0,
"pinTryExceeds": 0,
"maskedPan": "string",
"embossedName": "string",
"expiryDate": "string",
"CVV": "string",
"startDate": "string",
"endDate": "string",
"countryCode": "string", // Inherited from the User's country
"currencyCode": "string", // Always EUR
"lang": "string", // Inherited from the User's language
"deliveryTitle": "string",
"deliveryLastname": "string",
"deliveryFirstname": "string",
"deliveryAddress1": "string",
"deliveryAddress2": "string",
"deliveryAddress3": "string",
"deliveryCity": "string",
"deliveryPostcode": "string",
"deliveryCountry": "string",
"mobileSent": "string", // Inherited from the User's phone
"limitsGroup": "string",
"permsGroup": "string",
"cardDesign": "string",
"virtualConverted": 0,
"optionAtm": 0,
"optionForeign": 0,
"optionOnline": 0,
"optionNfc": 0,
"limitAtmYear": 0,
"limitAtmMonth": 0,
"limitAtmWeek": 0,
"limitAtmDay": 0,
"limitAtmAll": 0,
"limitPaymentYear": 0,
"limitPaymentMonth": 0,
"limitPaymentWeek": 0,
"limitPaymentDay": 0,
"limitPaymentAll": 0,
"paymentDailyLimit": 0,
"totalAtmYear": 0,
"totalAtmMonth": 0,
"totalAtmWeek": 0,
"totalAtmDay": 0,
"totalAtmAll": 0,
"totalPaymentYear": 0,
"totalPaymentMonth": 0,
"totalPaymentWeek": 0,
"totalPaymentDay": 0,
"totalPaymentAll": 0,
"createdBy": 0,
"createdDate": "string",
"modifiedBy": 0,
"modifiedDate": "string",
"renewalType": "string",
"renewalDate": "string",
"originalCardId": 0,
"totalRows": 0,
"designCode": "string",
"cardLanguages": "string",
"eventName": "string", // Inherited from the Wallet the card is attached to
"eventAlias": "string", // Inherited from the Wallet the card is attached to
"restrictionGroupLimits": [
{
"paymentDailyLimit": 0,
"mccRestrictionGroups": 0,
"countryRestrictionGroups": 0,
"merchantIdRestrictionGroups": 0
}
],
"cancellationNumber": "string",
"metadata": "string",
"renewalDate": "string",
"renewalType": "string",
"originalCardId": 0,
"logoId": "string",
"logoBackId": "string",
"packageId": "string",
"customizeInfo": "string",
"letterCustomizedInfo": "string",
"freeCustomizedInfo": "string",
"deliveryMethod": 0,
"pinMailer": 0,
"batchDeliveryId": 0,
"sendToParent": 0
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
Endpoints
Endpoint | Scope |
---|---|
/v1/cards/CreateVirtual Create a new Virtual Card | read_write |
/v1/cards/RequestPhysical Request a new Physical Card | read_write |
/v1/cards/Register3DS Register a Card for 3D Secure | read_write |
/v1/cardimages Retrieve a Virtual (or Virtual converted) Card image | read_write |
/v1/cards Search Cards | read_only |
/v1/cards/{cardId} Retrieve a Card using its id | read_only |
/v1/cards/{cardId} Update a Card information | read_write |
/v1/cards/{cardId}/Activate Activate a Card initially | read_write |
/v1/cards/{cardId}/Assign Assign or Reassign a Card to a User | read_write |
/v1/cards/{cardId}/ChangePIN Change a PIN (requires to know the previous one) | read_write |
/v1/cards/{cardId}/setPIN Define a PIN code | read_write |
/v1/cards/{cardId}/UnblockPIN Unblock a PIN code | read_write |
/v1/cards/{cardId}/ConvertVirtual Convert a Virtual Card to a Physical one | read_write |
/v1/cards/{cardId}/Limits Change a Card limits | read_write |
/v1/cards/{cardId}/Options Change a Card options | read_write |
/v1/cards/{cardId}/LockUnlock Toggle the locking status of a Card | read_write |
/v1/cards/{cardId}/Regenerate Regenerate a Virtual Card image | read_write |
If you have migrated to the PCI DSS services, please note some endpoints have been replaced. See the list of PCI DSS-specific endpoints for more information.