Create digital wallet token provisioning request for XPay - Marqeta Docs

POST//

This endpoint is limited in availability. For more information, contact your Marqeta representative.

Use this endpoint to return card data for use in provisioning a digital wallet token into an XPay digital wallet. The returned card data is encrypted using the digital wallet provider’s encryption key, thereby reducing your Payment Card Industry (PCI) compliance overhead.

Request body

Fields	Description
card_token string Required	Unique identifier of the card resource to use for the provisioning request. Allowable Values: 1–36 chars
device_id string Required	Unique identifier of the user’s XPay device, as provided by XPay during the provisioning process. Allowable Values: 1–24 chars
device_type string Required	Type of device into which the digital wallet token will be provisioned. Allowable Values: `MOBILE_PHONE`, `TABLET`, `WATCH`
provisioning_app_version string Required	Version of the application making the provisioning request. Used for debugging and fraud prevention. Allowable Values: 1–50 chars
token_requestor_id string Required	Unique numerical identifier of the digital wallet token requestor within the card network. These ID numbers map to `token_requestor_name` field values as follows: Mastercard - 50110030273 – `APPLE_PAY` - 50120834693 – `ANDROID_PAY` - 50139059239 – `SAMSUNG_PAY` Visa - 40010030273 – `APPLE_PAY` - 40010075001 – `ANDROID_PAY` - 40010043095 – `SAMSUNG_PAY` - 40010075196 – `MICROSOFT_PAY` - 40010075338 – `VISA_CHECKOUT` - 40010075449 – `FACEBOOK` - 40010075839 – `NETFLIX` - 40010077056 – `FITBIT_PAY` - 40010069887 – `GARMIN_PAY` Allowable Values: 11 char max Example Values: - Mastercard – 50110030273, 50120834693, 50139059239 - Visa – 40010030273, 40010075001, 40010075338, 40010075449, 40010075839, 40010043095
wallet_account_id string Required	User’s XPay account identifier, as provided by XPay during the provisioning process. Allowable Values: 1–50 chars

Response body

Fields	Description
card_token string Returned	Unique identifier of the card resource to use for the provisioning request. Allowable Values: 1–36 chars
created_time datetime Returned	Date and time when the digital wallet provisioning request was created, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ
last_modified_time datetime Returned	Date and time when the digital wallet token provisioning request was last updated, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ
push_tokenize_request_data object Conditionally returned	Contains details about a card tokenization push request. Allowable Values: `card_type`, `display_name`, `extra_provision_payload`, `last_digits`, `network`, `token_service_provider`
push_tokenize_request_data.card_type string Conditionally returned	Specifies the type of card. Allowable Values: `PAYMENT`, `DEBIT`, `CREDIT`, `LOYALTY`, `GIFT`
push_tokenize_request_data.display_name string Conditionally returned	Name of the card as displayed in the digital wallet, typically showing the card brand and last four digits of the primary account number (PAN). `Visa 5678`, for example. Allowable Values: Any value
push_tokenize_request_data.extra_provision_payload string Conditionally returned	Encrypted card or cardholder details. Allowable Values: Any value
push_tokenize_request_data.last_digits string Conditionally returned	Last four digits of the primary account number of the physical or virtual card. Allowable Values: 4 chars
push_tokenize_request_data.network string Conditionally returned	Specifies the card network of the physical or virtual card. Allowable Values: `Visa`, `Mastercard`
push_tokenize_request_data.token_service_provider string Conditionally returned	Specifies the network that provides the digital wallet token service. Allowable Values: `TOKEN_PROVIDER_VISA`, `TOKEN_PROVIDER_MASTERCARD`