BulkDetails
Contains information about the bulk card creation.
Array [
]
- 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.
The ID of the given Bulk Card Ordering
request.
The number of successfully created cards.
Possible values: [COMPLETED
, PROCESSING
, FAILED
, PENDING
]
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.
deliveryAddress
object
The DeliveryAddress object will be used for the PHYSICAL
card delivery. It must be null in case of VIRTUAL
card
Possible values: >= 4 characters
and <= 40 characters
The first line of the address.
Possible values: <= 30 characters
The second line of the address.
Possible values: <= 30 characters
The third line of the address.
Possible values: <= 30 characters
Max 30 characters: letters, spaces, hyphen and period
Possible values: >= 2 characters
and <= 2 characters
Country code in ISO-3166 Alpha 2
Possible values: <= 3 characters
The field is mandatory for US Customers: 2 to 3 characters state or province abbreviation. Example: "UT"
Possible values: non-empty
and <= 16 characters
For EU customers: maximum length 16
For US customers: Pattern: ^[a-zA-Z0-9-\ ]*$
minimum 4, maximum 10
cards
object[]
Card id is a unique identifier for a specific card. It will be used for most operations to the prepaid card.
Possible values: non-empty
and <= 40 characters
External card identifier in merchant system.
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).
Possible values: [ASSIGNED
, NOT_ASSIGNED
]
ASSIGNED
- Bulk card is assigned to a customer.
NOT_ASSIGNED
- Bulk card is not assigned to a customer.
Possible values: non-empty
and <= 27 characters
The name that appears on the card. If not provided, firstName lastName
from the customer will be used. Only ASCII characters are allowed.
expiry
object
Card expiry date.
The month of the card expiry date.
The year of the card expiry date.
Possible values: [PHYSICAL
, VIRTUAL
]
Supported card types. Currently we support only VIRTUAL
and PHYSICAL
Card program name.
Possible values: >= 4 characters
and <= 4 characters
Card last four digits.
Possible values: >= 3 characters
and <= 3 characters
Currency code in three-letter format ("Alpha-3").
Possible values: [VISA
, MC
]
Indicates that the card PIN has been set or not.
meta
object
Contains paging information regarding the returned records, when response is paginated.
The input for paginated query contains two parameters:
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
.
This is the requested number of records to be returned per page.
This is the requested starting position of the response, where 0 is the first record.
This is the page of records on which the lookup starts. The starting page is 1.