Skip to main content

Physical cards

Create and manage physical cardsPhysical Card A payment card that is printed or embedded in wearables and sent to customers directly. Physical cards are created by first creating a virtual card and then upgrading it to a physical card. They are sent in an inactive state and must be activated by the card assignee before first use. for your customers using our API. You can print physical cardsPhysical Card A payment card that is printed or embedded in wearables and sent to customers directly. Physical cards are created by first creating a virtual card and then upgrading it to a physical card. They are sent in an inactive state and must be activated by the card assignee before first use. or embed them in wearables and send them directly to your customers.

Set up your card program​

You can customize physical cardsPhysical Card A payment card that is printed or embedded in wearables and sent to customers directly. Physical cards are created by first creating a virtual card and then upgrading it to a physical card. They are sent in an inactive state and must be activated by the card assignee before first use. to match your branding. Before you can issue physical cardsPhysical Card A payment card that is printed or embedded in wearables and sent to customers directly. Physical cards are created by first creating a virtual card and then upgrading it to a physical card. They are sent in an inactive state and must be activated by the card assignee before first use., you need to set up your card program. This includes preparing your artwork, choosing the right card material, finishing, and selecting a card carrier. Read more on the different options offered by Weavr in the card stock setup guide. Additional fees apply.

tip

In your application, you can set up multiple card programs with different artworks.

Create a physical card​

To create a physical cardPhysical Card A payment card that is printed or embedded in wearables and sent to customers directly. Physical cards are created by first creating a virtual card and then upgrading it to a physical card. They are sent in an inactive state and must be activated by the card assignee before first use., you need to first create a virtual card and then upgrade it to a physical cardPhysical Card A payment card that is printed or embedded in wearables and sent to customers directly. Physical cards are created by first creating a virtual card and then upgrading it to a physical card. They are sent in an inactive state and must be activated by the card assignee before first use.. After you set up your card program, you can upgrade any of your virtual cardsVirtual Card A payment card that is created instantly and can be used for e-commerce and online purchases. Virtual cards are issued through the Mastercard network and are automatically enrolled in the 3D Secure program for increased security and limited fraud risk. They can be created in prepaid or debit mode. to physical cardsPhysical Card A payment card that is printed or embedded in wearables and sent to customers directly. Physical cards are created by first creating a virtual card and then upgrading it to a physical card. They are sent in an inactive state and must be activated by the card assignee before first use..

To upgrade a card, you need to specify the productReference and carrierType properties. These fields identify the card stock and card carrier to be used.

Card sensitive information

The card PIN is considered PCI-sensitive data and needs to be tokenized if you are not PCI compliant. Learn how to securely capture your user's preferred PIN using the capture card PIN UI component.

POST/managed_cards/{id}/physicalTry it 
{
  "productReference": "string",
  "carrierType": "string",
  "deliveryMethod": "STANDARD_DELIVERY",
  "deliveryAddress": {
    "name": "string",
    "surname": "string",
    "addressLine1": "string",
    "addressLine2": "string",
    "city": "string",
    "postCode": "string",
    "state": "string",
    "country": "st",
    "contactNumber": "string"
  },
  "activationCode": "string",
  "pin": {
    "value": "string"
  },
  "nameOnCardLine2": "string",
  "bulkDelivery": true
}

The physical cardPhysical Card A payment card that is printed or embedded in wearables and sent to customers directly. Physical cards are created by first creating a virtual card and then upgrading it to a physical card. They are sent in an inactive state and must be activated by the card assignee before first use. details are returned in the response. The card is shipped in an inactive state — see activation for the next step.

Retrieve the physical card PIN​

Physical cardsPhysical Card A payment card that is printed or embedded in wearables and sent to customers directly. Physical cards are created by first creating a virtual card and then upgrading it to a physical card. They are sent in an inactive state and must be activated by the card assignee before first use. issued by Weavr are chip-and-PIN cards. When the card assigneeCard Assignee The person that a card is assigned to and who will use the card. For consumers, the card owner and card assignee are the same person. For corporates, the card assignee and card owner are different entities - the corporate is the card owner and the person using the card is the card assignee. Card assignees must be created as Authorised Users. makes a purchase at a physical point-of-sale, they must input the PIN associated with the card as an additional security layer.

You can allow your customers to specify a personalized PIN when creating a physical card.

info

If a PIN is not specified when the card is created, Weavr assigns a randomly generated PIN to the card.

You can retrieve the card PIN using our API.

GET/managed_cards/{id}/physical/pinTry it 
{
  "pin": {
    "value": "string"
  }
}

The card PIN is returned in the response, tokenized. You can display the plain text card PIN to your customers using the show card PIN UI component.