Overview
If your programme offers a physical card, there are additional steps to enable these for users.Prerequisites
All the same prerequisites for virtual cards also apply to physical cards. In many but not all cases, the user will already have a virtual card and meet all the prequisites, and all that remains is to “upgrade” the user. The rest of this section will assume the user already has an active virtual card, although this is not necessary and this flow can be started any time the user meets the prerequisites of a virtual card, if a physical product has been enabled for your programme.Ordering
Physical cards are built on the Order Processing Service. This provides capabilities specific to physical cards including logistics, and the ability to charge users if appropriate to the product (e.g. for premium accounts with extra features, or metal cards).Products
The Order Service recognises Products. A Product could be anything, but for our purposes here is typically a physical card (plastic or metal), a premium account, or both. You may be supplied a unique Product ID for use in the rest of the flow, but to future-proof the support of multiple products we also provide a way to enumerate all your supported products.Flow
- Create a new order for the required Product ID.
- Where the product requires payment from the user, the response will provide the information to being payment.
- When the user completes a supported payment flow and we receive notification, the selected product will be issued:
- If there is a physical card, the new card information will be issued and the order for dispatch also prepared
- If there is an account upgrade, this will take immediate effect.
- At any time, the status of an order can be queried to check progress/inform the user.