Skip to main content

BulkCardsRequest

Bulk Card Ordering request contains the necessary information for card creation.

The cards field operates at the per-card level and can be used to specify the card's PIN and the name that will be printed on the PHYSICAL card.

    quantity integerrequired

    Possible values: >= 1 and <= 50

    Default value: 1

    The number of cards to be created.

    programName stringrequired

    Program name provided by Paysafe.

    currency stringrequired

    Possible values: >= 3 characters and <= 3 characters

    Currency code in three-letter format ("Alpha-3").

    mobile string

    Possible values: Value must match regular expression ^\+\d+\s?\d{1,16}$

    If not provided, we will try to use the mobile phone provided during the customer onboarding. Mobile phone number must be in format "+359888333333".

    deliveryAddress

    object

    The DeliveryAddress object will be used for the PHYSICAL card delivery. It must be null in case of VIRTUAL card

    address1 stringrequired

    Possible values: >= 4 characters and <= 40 characters

    The first line of the address.

    address2 string

    Possible values: <= 30 characters

    The second line of the address.

    address3 string

    Possible values: <= 30 characters

    The third line of the address.

    city stringrequired

    Possible values: <= 30 characters

    Max 30 characters: letters, spaces, hyphen and period

    countryCode stringrequired

    Possible values: >= 2 characters and <= 2 characters

    Country code in ISO-3166 Alpha 2

    state string

    Possible values: <= 3 characters

    The field is mandatory for US Customers: 2 to 3 characters state or province abbreviation. Example: "UT"

    postalCode stringrequired

    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