How to assign multiple cards at once?

There are three ways to assign business cards in the Sparados service:

1. Filling out the card assignment form (by clicking the ASSIGN CARD button).

2. Assigning a card using the Sparados API (link to documentation).

3. Using a batch file to assign multiple cards at once.

   
   

Assigning cards from a batch file works similarly to filling out the form from option 1, but it allows you to assign multiple cards simultaneously.

In this tutorial, you'll learn how to do it:

Go to the CARDS tab

After clicking the ASSIGN MULTIPLE button, you will be redirected to the page for assigning multiple cards. Here, you need to upload a valid .csv file containing all the information required to generate the cards. You can use the sample file "example.csv" provided above the main field as a reference (The data in the file is for example purposes and should be replaced).

All group limits will follow the same rules as when assigning a single card. If the assigned limit exceeds your group's limit, approval will need to be obtained from the higher-level group.

If the information in the file is in an incorrect format, the system will display a message indicating the issue with a specific row or cell:

The file should include:

Field Name	Format	Description	Example
operation	text field	Operation Type REQUIRED	assign - when card needs to be assgned
approvalId	UUID	Loan ID Not required for the "assign" operation	4b8a4286-4c79-475f-8932-4f3b29e7610e
email	email	Employee's email address REQUIRED	john.doe@sparados.com
phonePrefix	prefix	Employee's phone number prefix REQUIRED	48
phoneNumber	phone number	Employee's phone number REQUIRED	123456789
totalAmount	number field	Account balance (for decimal amounts, use a dot as the separator) REQUIRED	2000.99
limitGeneral	amount:period	Periodic limit for all types of transactions with the period (daily, weekly, monthly) OPTIONAL (no limit by default)	50:weekly
limitEcommerce	amount:period	Periodic limit for online payments OPTIONAL (no limit by default)	100:monthly
limitAtm	amount:period	Periodic ATM withdrawal limit (To block ATM withdrawals, enter 0:daily)OPTIONAL (no limit by default)	50:daily
limitForeignTransaction	amount:period	Periodic foreign transaction limit OPTIONAL (no limit by default)	50:daily
startDate	Date	Account start date in the format YYYY-MM-DD, YYYY.MM.DD, or YYYY/MM/DD REQUIRED	2025-01-01
endDate	Date	Account expiration date in the format YYYY-MM-DD, YYYY.MM.DD, or YYYY/MM/DD REQUIRED	2027-01-01
cardAliasId	UUID	Account ID (you can find it in account details in the ACCOUNTS tab) REQUIRED	1ee5c171-393c-6140-b3d6-b9784a774ec2
visualId	UUID	Card graphic ID (you can find it on the card template in the CARDS -> ASSIGN CARD tab) OPTIONAL	4b8a1286-4c79-475f-8932-4f3b29e7610e
cardName	text field	Card name OPTIONAL (empty by default)	Lunch card Adam Kowalski
allowChangeRequests	yes/no	Ability to request a limit increase OPTIONAL (yes by default)	yes

Most fields should be straightforward, but two columns might be harder to identify: Account ID and Card Graphic ID

Account ID:

ACCOUNTS -> Select an account

In the account details, next to the name of your account, there is a button to copy the Account ID

Card Graphic ID:

CARDS -> ASSIGN CARD

Scroll down to the Card Attributes section and select the graphic you want to assign to your new card. A button to copy the Graphic ID will appear.

If you have filled in all fields in the correct format, save your file with the extension CSV (Comma delimited) (*.csv) or CSV UTF-8 (Comma delimited) (*.csv). Upload it to the field with the "drop file or browse" cloud on the panel. You should see a message confirming that your cards are being processed.

In the REPORTS -> BULK CARD ASSIGNMENT tab, you can track the status of card assignments and download the report when it is ready. You will also see the date, information about the number of assigned cards, and how many were successful or failed.

After downloading the report, you can open it in programs like Excel or Numbers. It contains three additional columns:

Field name	Description	Example
status	This field will display one of two messages (success, error), indicating the outcome of the operation.	error
statusCode	Code for the status (helps you identify the error)	400
message	Account ID in case of success, or error description in case of failure.	Item not found for "/management/card_aliases/027512d8-faaf-42f2-88e6-80fb7c53dcf".

Comparison of Card Assignment via API and Batch File:

API

Advantages:

✅ Integration with own systems

✅ Full automation of card management process

✅ Free access to Sparados API (API documentation)

Disadvantages:

❌ Implementation cost on the client’s side (approximately 20,000 - 40,000 PLN)

❌ Need to maintain a service connected to the API

❌ Implementation time: approximately 2 - 3 months

Advantages:

✅ Immediate implementation possible

✅No implementation or maintenance costs

Disadvantages:

❌ Manual work required to create the file

❌ Manually uploading the file to the service