Request a physical card for individual delivery

Use this when you need to issue a physical card for an existing virtual card.

It requests a physical card for the virtual card identified by the id path parameter to a physical card and sends it as an individual delivery. Each request creates one physical card. The card is personalized, sealed in its own envelope with a card carrier, and sent directly to the recipient in deliveryAddress.

Prerequisites

Before cards can be upgraded, a physical card programme must be set up and the card profile configuration updated accordingly.

Fields

Set bulkDelivery to false or omit it.

Address

deliveryAddress.name and deliveryAddress.surname identify the cardholder and are printed on the card carrier. If the card is linked to a user, the linked user's name and surname take precedence over these values. The remaining deliveryAddress fields identify where the individual card is sent.

Delivery methods

Individual delivery supports STANDARD_DELIVERY, REGISTERED_MAIL, COURIER, and FIRST_CLASS_MAIL. deliveryAddress.contactNumber is required when using COURIER; it isn't used for other delivery methods.

US deliveries must use COURIER. When deliveryAddress.country is US, any other deliveryMethod, or omitting it, is rejected with a REQUIRES syntax error on deliveryMethod, unless your programme is configured to convert the delivery method to COURIER automatically.

Tracking fulfillment

Once the request is accepted, Weavr sends the Physical card fulfillment status webhook (/managed_cards/physical_cards_upgrade/watch) each time physicalCardDetails.manufacturingState changes (REQUESTED → SENT_FOR_FULFILLMENT → DISPATCHED → DELIVERED). The same state is available on demand via Get a card.