Shipping and delivery

Lookup tables for printing physical cards: delivery address fields and the shipping providers available per hub.

Delivery address

When printing physical cards with the printPhysicalCard, addCards, and addCardsWithGroupDelivery mutations, use the address fields according to the following guidelines.

Field Requirements Legend

● REQ Required:Must be completed.

◐ CND Conditional:Required only in specific situations.

○ OPT Optional:Isn't required; may have a default value.

Field	Requirement	Provided by	Purpose	Example
companyName	◐ CND	Swan API	Automatically retrieves the account holder name (company cards only). You can provide a different value with the addCardsWithGroupDelivery mutation.	MyBrand
firstName, lastName	◐ CND	Swan API	Automatically retrieves the account member's first and last names. You can provide different values with the addCardsWithGroupDelivery mutation.	Jules Fleury
addressLine1	● REQ	You	Delivery address line 1 (don't include the company name here)	13 Avenue de Paris
addressLine2	○ OPT	You	Additional address information (don't include the company name here)	Suite 26
city	● REQ	You	Delivery city	Paris
postalCode	● REQ	You	Delivery postal code (max 10 characters)	75000
state	○ OPT	You	Delivery state	Ile de France
country	● REQ	You	Country using the alpha-3 code format (ISO 3166)	FRA

Shipping providers

You can set the shipping method for your users' physical cards. To do so, select the shippingProvider option in the physicalCardCustomOptions input when you add a card, or use the printPhysicalCard mutation.

Choose from the following options:

Shipping provider	Shipping hub
LaPosteTracked	France
LaPosteUntracked	France
DHL	France
CorreosTracked	Spain
CorreosUntracked	Spain
NACEX	Spain

For details on delivery types and destinations, read more about the France and Spain hubs. Make sure to select a shipping provider that's compatible with both the printing hub and the destination country that you chose. Selecting an incompatible provider returns an InvalidShippingProviderRejection error.

Shipping costs

Shipping costs depend on:

• Destination
• Delivery type (group or non-group, tracked or untracked)

International shipments may incur additional fees.