Create Cards Batch
Learn how to create a batch of cards.
This endpoint allows you to order a batch of cards. It allows you to create a batch of personalized cards - with your own design - or a batch of unnominated cards also with your own design.
In the case of unnominated cards, you can select your own warehouse and then distribute them.
post
https://api.dlocal.com/issuing/cards/batches
Create Cards Batch

Cards batch object

Batch object
Customer reference object
Delivery address object
Property
Type
Description
country
String
Cards batch’s country code. ISO 3166-1 alpha-2-code.
quantity
Integer
Number of existing cards in the Batch.
min_stock
Integer
Minimum number of cards to trigger a stock alarm to the mail informed in the customer's object.
issue_type
String
Type of card to be issued. Enum ('NOMINATED' , 'UNNOMINATED')
distribution_type
String
Applies only to unnominated cards. Enum ('DLOCAL', 'MERCHANT').
batch_reference
String
Merchant reference.
contact
Object
Customer's order information.
delivery_address
Object
Merchant’s delivery address. Applies only to unnominated cards.
Property
Type
Description
first_name
String
Customer's first name.
last_name
String
Customer's last name.
email
String
Customer's email.
phone
String
Customer's phone.
Property
Type
Description
country
String
Cards batch’s country code. ISO 3166-1 alpha-2-code.
city
String
Merchant's address city code. The same codes as the cardholder owner are used.
state
String
Merchant's address state code. The same codes as the cardholder owner are used.
street
String
Merchant's address street.
street2
String
Additional information on the street.
house_number
String
Merchant's house number (floor, apartment).
zip_code
String
Merchant's address zip code.
neighbourhood
String
Neighbourhood or district.

Response Attributes

Property
Type
Description
batch_id
String
Cards batch’s ID.
batch_reference
String
Merchant reference.
contact
Object
Customer's order information.
country
String
Cards batch’s country code. ISO 3166-1 alpha-2-code.
quantity
Integer
Number of existing cards in the Batch.
min_stock
Integer
Minimum number of cards stock to trigger an alarm.
issue_type
String
Type of card to be issued. Enum ('NOMINATED' , 'UNNOMINATED')
distribution_type
String
Applies only to unnominated cards. Enum ('DLOCAL', 'MERCHANT').
delivery_address
Object
Merchant’s delivery address. Applies only to unnominated cards.
status
String
Batch's delivery status ('CREATED', 'DELIVERED', 'REJECTED')
Copy link
On this page
post
Create Cards Batch
Cards batch object
Response Attributes