BulkDetails
Contains information about the bulk card creation.
The ID of the given Bulk Card Ordering
request.
The number of successfully created cards.
COMPLETED
- Bulk card creation completed successfully.
PROCESSING
- Bulk card creation is currently in progress.
FAILED
- Bulk card creation has failed.
PENDING
- Bulk card creation is waiting to be completed.
Possible values: [COMPLETED
, PROCESSING
, FAILED
, PENDING
]
deliveryAddress object
The DeliveryAddress object will be used for the PHYSICAL
card delivery. It must be null in case of VIRTUAL
card
The first line of the address.
Possible values: >= 4 characters
and <= 40 characters
Tsarigradsko Shose 73
The second line of the address.
Possible values: <= 30 characters
floor 3
The third line of the address.
Possible values: <= 30 characters
apartment 43
Max 30 characters: letters, spaces, hyphen and period
Possible values: <= 30 characters
Sofia
Country code in ISO-3166 Alpha 2
Possible values: >= 2 characters
and <= 2 characters
BG
The field is mandatory for US Customers: 2 to 3 characters state or province abbreviation. Example: "UT"
Possible values: <= 3 characters
UT
For EU customers: maximum length 16
For US customers: Pattern: ^[a-zA-Z0-9-\ ]*$
minimum 4, maximum 10
Possible values: non-empty
and <= 16 characters
1000
cards object[]
Card id is a unique identifier for a specific card. It will be used for most operations to the prepaid card.
External card identifier in merchant system.
Possible values: non-empty
and <= 40 characters
B-1111111
If the status is ASSIGNED
the customerId will represent the real id of the customer or if the status is NOT_ASSIGNED
customerId will contain the merchant id (provided in the request).
1231122232
ASSIGNED
- Bulk card is assigned to a customer.
NOT_ASSIGNED
- Bulk card is not assigned to a customer.
Possible values: [ASSIGNED
, NOT_ASSIGNED
]
The name that appears on the card. If not provided, firstName lastName
from the customer will be used. Only ASCII characters are allowed.
Possible values: non-empty
and <= 27 characters
John Doe
expiry object
Card expiry date.
The month of the card expiry date.
3
The year of the card expiry date.
2028
Supported card types. Currently we support only VIRTUAL
and PHYSICAL
Possible values: [PHYSICAL
, VIRTUAL
]
Card program name.
Card last four digits.
Possible values: >= 4 characters
and <= 4 characters
3234
Currency code in three-letter format ("Alpha-3").
Possible values: >= 3 characters
and <= 3 characters
EUR
Possible values: [VISA
, MC
]
Indicates that the card PIN has been set or not.
false
meta object
Contains paging information regarding the returned records, when response is paginated.
The input for paginated query contains two parameters:
- limit - This is the requested number of records to return. Defaults to 10 and maximum is 50.
- offset - This is the requested starting position of the response, where 0 is the first record. Default = 0.
Note! The total number of records is not returned, to prevent queries spanning on all records. If
numberOfRecords
<limit
, this means no further pages are available. On request of offset beyond the last record, the returnednumberOfRecords
is 0.
The number of previous pages can be calculated by dividing offset
to limit
.
This is the number of records returned in the lookup. Always numberOfRecords
is smaller than or equal to limit
.
1
This is the requested number of records to be returned per page.
10
This is the requested starting position of the response, where 0 is the first record.
0
This is the page of records on which the lookup starts. The starting page is 1.
1
{
"id": "string",
"quantity": 0,
"status": "COMPLETED",
"deliveryAddress": {
"address1": "Tsarigradsko Shose 73",
"address2": "floor 3",
"address3": "apartment 43",
"city": "Sofia",
"countryCode": "BG",
"state": "UT",
"postalCode": "1000"
},
"cards": [
{
"cardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"externalId": "B-1111111",
"customerId": "1231122232",
"status": "ASSIGNED",
"embossedName": "John Doe",
"expiry": {
"month": 3,
"year": 2028
},
"cardType": "PHYSICAL",
"programName": "string",
"lastFour": "3234",
"currency": "EUR",
"scheme": "VISA",
"isPinSet": false
}
],
"meta": {
"numberOfRecords": 1,
"limit": 10,
"offset": 0,
"page": 1
}
}