Create digital wallet token provision request for Apple Pay

Action: POST
Endpoint: /digitalwalletprovisionrequests/applepay

To return card data for use in provisioning a digital wallet token into an Apple Wallet, send a POST request to the /digitalwalletprovisionrequests/applepay endpoint and include the request details in JSON format in the body of the request. The returned card data is encrypted using the digital wallet provider's encryption key, thereby reducing PCI compliance overhead for Marqeta customers.

Body field details

Name Type Required? Description Allowable Values
card_token string Yes Identifies the card to use for the provision request. Existing card token.

Issue a GET to /cards/user/{user_token} to retrieve card tokens for a specific user.
device_type string Yes The type of device into which the digital wallet token will be provisioned. MOBILE_PHONE |
WATCH |
TABLET |
MOBILE_PHONE_OR_TABLET |
VEHICLE |
APPLIANCE |
LAPTOP |
GAMING_DEVICE |
UNKNOWN
provisioning_app_version string Yes Version of the application making the provisioning request (used for debugging and fraud). 50 char max
certificates array of strings Yes Leaf and sub-CA certificates provided by Apple. Array of Base64 encoded certificates from Apple.

The first element of the array should be the leaf certificate followed by the sub-CA certificate.
nonce string Yes One-time-use nonce provided by Apple for security purposes. Base64 encoded nonce from Apple.
nonce_signature string Yes Apple-provided signature to the nonce. Base64 encoded nonce signature from Apple.

Sample request

{
"card_token": "a00cac6c-a5c8-4e8d-b8aa-54f2238ef646",
"device_type": "MOBILE_PHONE",
"provisioning_app_version": "2.13.7",
"certificates": [ "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" ],
"nonce": "vXWJaBidcTLaJJCF",
"nonce_signature": "jD4Aphu+93N2wbBn"
}

Sample response

{
"created_time": "2017-03-22T21:22:19Z",
"last_modified_time": "2017-03-22T21:22:19Z",
"card_token": "a00cac6c-a5c8-4e8d-b8aa-54f2238ef646",
"encrypted_pass_data": "w9NGKYa3OkPGeQ+FmAKGgaVDbmV/UE7jdgBcE1RpbUc4pw+V4bDnSzNq1ndvSjHuTTa2xl2HIACb2W0uNN+759TLnusGc9FeLpBo5IMpUBi/XBK488BPqDB7qgeXFpvz5iU8X+ZIMG1WwpS5KEkwoqbcnSmTIfxnj7j8QzLFeP7N9jPk8NeuQlAcgSf6EFQKll8OazvFLKjQol+/gwoAfPOfjXZo+gw2xEG6WNKBg2R0r8q2c14cILPm17liTSzqbW4gB1HUz3+pxJEGKI5+z8hf7wN/uY2nd4xQ937TNVmvSE/qZXmzK5vYtWkkXvwgCFwHGk4FEjaQocZro0CYV/Io4+vPao5wINKOt0lrsjo9cMU/nzPhwz2lEMg8vPC3fXF93vbfSLzN3qhBoejrwxPRqI0a6yPWSPFGO8zstPNwMKoE2GQF+swPUJxBlJL05ZSlneHpITahdp7gEvCZolZEjht4inQcwwYvxgtp3MdVC5fxl/i9mYbVi/epHa6If0tudb2vIeiJfeTZwnTUc6XJFV2g6nnmG5gCPE42NcNCYcaG1Cn9qDdwD7h8l2KC78v37I2jkxbNp7pi0MoP4PFZdw==",
"activation_data": "TUJQQUMtMS1GSy03NDgwNTIuMS0tVERFQS00RjU4OTZGMUE3NEUyNTdFNDAxRDg2RjUwOENBNEUyMkJBRjE1RTExOTA3RDlGQkE3ODJCQTMwNjIyMkJFOUI4OUE2QUZGMjA4MDU5RTA3NzhGMzA5QjIxRkNDNTVGNERDQ0VCMjMwNUM3MzBCMzEy",
"ephemeral_public_key": "BMop3NufgKwy/r0GX1muvomvwFfKAYMYY74bvq3TyktjrZ/+6uzQCiIz/dx5Mii7bUuVIJ84C+5I6by05Zhdd3A="
}


Create digital wallet token provision request for Android Pay

Action: POST
Endpoint: /digitalwalletprovisionrequests/androidpay

To return card data for use in provisioning a digital wallet token into an Android Wallet, send a POST request to the /digitalwalletprovisionrequests/androidpay endpoint and include the request details in JSON format in the body of the request. The returned card data is encrypted using the digital wallet provider's encryption key, thereby reducing PCI compliance overhead for Marqeta customers.

Body field details

Name Type Required? Description Allowable Values
card_token string Yes Identifies the card to use for the provision request. Existing card token.

Issue a GET to /cards/user/{user_token} to retrieve card tokens for a specific user.
device_type string Yes The type of device into which the digital wallet token will be provisioned. MOBILE_PHONE |
WATCH |
TABLET |
MOBILE_PHONE_OR_TABLET |
VEHICLE |
APPLIANCE |
LAPTOP |
GAMING_DEVICE |
UNKNOWN
provisioning_app_version string Yes Version of the application making the provisioning request (used for debugging and fraud). 50 char max
wallet_account_id string Yes The user's Android User Wallet Account ID. 50 char max
device_id string Yes The user's Android Device ID; the device's unique identifier. 24 char max

Sample request

{
  "card_token": "9d3dee7c-19df-4b71-bbb9-521bb04307bf",
  "device_type": "MOBILE_PHONE",
  "provisioning_app_version": "2.13.3",
  "wallet_account_id": "ae25OGhjZTk2dsr452dgsr51",
  "device_id": "W85OGhjZTk2dsr452dgsr51j"
}

Sample response

{
"card_token": "9d3dee7c-19df-4b71-bbb9-521bb04307bf",
"push_tokenize_request_data": {
"network": "Visa", 
"token_service_provider": "TOKEN_PROVIDER_VISA",   
"display_name": "Visa Card",     
"last_digits": "4563",   
"user_address": {     
"name": "John Doe",   
"address1": "180 Grand Ave",
"address2": "FL 5",
"city": "Oakland",
"state": "CA",
"zip": "94612",
"country": "US",
"phone": "925-831-9837"
},
"opaque_payment_card": "amFoc2J1YWhzamhza2pkZmhrZHM="
},
"created_time": "2016-09-12T18:39:20Z",
"last_modified_time":"2016-09-12T18:39:20Z"
}


Create digital wallet token transition

Action: POST
Endpoint: /digitalwallettokentransitions

To set the state of a digital wallet token, create a digital wallet token transition by sending a POST request to the /digitalwallettokentransitions endpoint. Include the transition details in JSON format in the body of the request. When you create any Marqeta resource, the system associates a token for referencing that resource. You can create your own token using any alpha-numeric characters, 36 chars max. If you do not include a token value, one is generated automatically.

Body field details

Name Type Required? Description Allowable Values
token string No The unique identifier of the digital wallet token transition (not the identifier of the digital wallet token itself).

If you do not include a value for the token field, the system will generate one automatically. This value is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated.
36 char max
digital_wallet_token object Yes Contains the token of the digital wallet token that will transition to a different state.
state string Yes Specifies the state to which the digital wallet token will transition.

The original state is REQUESTED. You cannot modify the state if its current value is either REQUEST_DECLINED or TERMINATED.
ACTIVE | SUSPENDED | TERMINATED
reason string No The reason for the transition. 255 char max

The digital_wallet_token object

Name Type Required? Description Allowable Values
token string Yes Identifies the digital wallet token that will transition to a different state. Existing digital wallet token token.

Issue a GET to /digitalwallettokens/card/{card_token} to retrieve digital wallet token tokens for a card.

The type field (response)

Every digital wallet token transition contains a type field, which cannot be set directly using the /digitalwallettokentransitions endpoint. The type field is managed by the Marqeta Platform, based on the state of the digital wallet token before and after the transition (as specified by the state field). The following table describes the type field's possible values:

Value Description
fulfillment.requested Digital wallet token was requested.
state.request_declined Digital wallet token request was declined.
state.activated Digital wallet token was activated.
state.suspended Digital wallet token was suspended.
state.reinstated Digital wallet token was re-activated from a suspended state.
state.terminated Digital wallet token was terminated.
card.swap A card was activated (the card state transitioned from UNACTIVATED to ACTIVE), and all existing digital wallet tokens owned by the user and having a state of REQUESTED, ACTIVE, or SUSPENDED were moved to the new card. When the type is card.swap, the response contains a card_swap object.

The card_swap object (response)

Field Name Type Required? Description Allowable Values
card_swap.previous_card_token string present when
type=card.swap
Token of the card with which the digital wallet was previously associated. Existing card token
card_swap.new_card_token string present when
type=card.swap
Token of the card with which the digital wallet is currently associated. Existing card token

The fulfillment_status field (response)

The digital wallet token transition response contains a fulfillment_status field that provides information regarding the associated digital wallet token's provisioning status. The following table describes this field's possible values:

Value Description
DECISION_RED Initial value when the token activation request decision is red.
DECISION_YELLOW Initial value when the token activation request decision is yellow.
DECISION_GREEN Initial value when the token activation request decision is green.
REJECTED The token activation request was declined.
PROVISIONED Digital wallet token was successfully activated and provisioned into the digital wallet.

Sample request

{
"token": "my_transition_04",
"digital_wallet_token": {
"token": "b98cb680-2fd4-4c14-aa56-8d05091209d5"
},
"state": "ACTIVE",
"reason": "Passed additional identity verification"
}

Sample response

{
"token": "my_transition_04",
"digital_wallet_token": {
"token": "b98cb680-2fd4-4c14-aa56-8d05091209d5"
},
"type": "state.activated",
"channel": "API",
"state": "ACTIVE",
"fulfillment_status": "PROVISIONED",
"reason": "Passed additional identity verification",
"created_time": "2017-02-23T18:57:45Z"
}


Retrieve digital wallet token transition

Action: GET
Endpoint: /digitalwallettokentransitions/{token}

To retrieve a specific digital wallet token transition, issue a GET request to the /digitalwallettokentransitions/{token} endpoint. Include the digital wallet token transition token path parameter to specify the digital wallet token transition to return.

This endpoint supports field filtering.

URL path parameters

Name Type Required? Description Allowable Values
token string Yes Identifies the digital wallet token transition to retrieve. Existing digital wallet token transition token.

Issue a GET to /digitalwallettokentransitions/digitalwallettoken/{token} to retrieve digital wallet token transition tokens for a particular digital wallet token.

Sample response

{
"token": "my_transition_04",
"digital_wallet_token": {
"token": "b98cb680-2fd4-4c14-aa56-8d05091209d5"
},
"type": "state.activated",
"channel": "API",
"state": "ACTIVE",
"fulfillment_status": "PROVISIONED",
"reason": "Passed additional identity verification",
"created_time": "2017-02-23T18:57:45Z"
}


List transitions for digital wallet token

Action: GET
Endpoint: /digitalwallettokentransitions/digitalwallettoken/{token}

To return an array of all transitions for a particular digital wallet token, issue a GET request to the /digitalwallettokentransitions/digitalwallettoken/{token} endpoint. Include the digital wallet token token as a URL path parameter.

This endpoint supports field filtering, pagination, and sorting.

URL path parameters

Name Type Required? Description Allowable Values
token string Yes The token identifying the digital wallet token whose transitions you want to list. Existing digital wallet token token.

Issue a GET to /digitalwallettokens/card/{card_token} to retrieve digital wallet token tokens for a specific card.

Sample response

{
"count": 2,
"start_index": 0,
"end_index": 1,
"is_more": false,
"data": [
{
"token": "my_transition_04",
"digital_wallet_token": {
"token": "b98cb680-2fd4-4c14-aa56-8d05091209d5"
},
"type": "state.activated",
"channel": "API",
"state": "ACTIVE",
"fulfillment_status": "PROVISIONED",
"reason": "Passed additional identity verification",
"created_time": "2017-02-23T18:57:45Z"
},
{
"token": "659654f0-d5e4-4875-8e3e-2ecf1babd03b",
"digital_wallet_token": {
"token": "b98cb680-2fd4-4c14-aa56-8d05091209d5"
},
"type": "fulfillment.requested",
"channel": "TOKEN_SERVICE_PROVIDER",
"state": "REQUESTED",
"fulfillment_status": "DECISION_YELLOW",
"reason": "Additional identity verification required",
"created_time": "2017-02-23T18:44:21Z"
}
]
}


Retrieve digital wallet token

Action: GET
Endpoint: /digitalwallettokens/{token}

To retrieve a specific digital wallet token, issue a GET request to the /digitalwallettokens/{token} endpoint. Include the digital wallet token token path parameter to specify the digital wallet token to return.

URL path parameters

Name Type Required? Description Allowable Values
token string Yes The token identifying the digital wallet token to retrieve. Existing digital wallet token token.

Issue a GET to /digitalwallettokens/card/{card_token} to retrieve digital wallet token tokens for a particular card.

Body field details (response)

Name Type Required? Description Allowable Values
token string No The unique identifier of the digital wallet token. 36 char max
card_token string No The unique identifier of the card. 36 char max
state string No The state of the digital wallet token.

For state descriptions, see Transitioning Token States.
REQUESTED |
REQUEST_DECLINED |
ACTIVE |
SUSPENDED |
TERMINATED
state_reason string No The reason the digital wallet token transitioned to its current state. 255 char max
fulfillment_status string No The digital wallet token's provisioning status.

For fulfillment status descriptions, see Create Digital Wallet Token Transition.
DECISION_RED |
DECISION_YELLOW |
DECISION_GREEN |
REJECTED |
PROVISIONED
issuer_eligibility_decision string No Marqeta's decision as to whether to provision the digital wallet token.

0000 – The token has been provisioned.

token.activation.verification.required – Provisioning is pending; further action is required for completion.
0000 |
cardaccount.verified |
card.suspicious |
token.activation.verification.required |
token.activation-request.decline |
card.not.active |
invalid.cid |
card.expired |
card.suspended |
cardholder.not.active
created_time string No The date and time the digital wallet token object was created. yyyy-MM-dd'T'HH:mm:ssZ
last_modified_time string No The date and time the digital wallet token object was last modified. yyyy-MM-dd'T'HH:mm:ssZ
token_service_provider object No Contains information held and provided by the token service provider (card network).
device object No Contains information related to the device being provisioned.
wallet_provider_profile object No Contains information held and provided by the digital wallet provider.
address_verification object No Contains information held by the card network and used for address verification of the card holder.

The token_service_provider object (response)

Name Type Required? Description Allowable Values
token_reference_id string No The unique identifier of the digital wallet token within the card network. 50 char max
pan_reference_id string No The unique identifier of the digital wallet token PAN within the card network. 50 char max
token_requestor_id string No The unique numerical identifier of the 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
MasterCard
50110030273 |
50120834693 |
50139059239

Visa
40010030273 |
40010075001 |
40010043095 |
40010075196 |
40010075338 |
40010075449 |
40010075839 |
40010077056 |
40010069887
token_requestor_name string No The name of the token requestor within the card network. MasterCard
APPLE_PAY |
ANDROID_PAY |
SAMSUNG_PAY

Visa
APPLE_PAY |
ANDROID_PAY |
SAMSUNG_PAY |
MICROSOFT_PAY |
VISA_CHECKOUT |
FACEBOOK |
NETFLIX |
FITBIT_PAY |
GARMIN_PAY
token_type string No The type of digital wallet token. MERCHANT_CARD_ON_FILE | DEVICE_SECURE_ELEMENT | DEVICE_CLOUD_BASED | ECOMMERCE_DIGITAL_WALLET
token_pan string No The digital wallet token PAN (primary account number).
token_expiration string No The expiration date of the digital wallet token. yyyy-MM-dd HH:mm:ss
token_score string No The token score assigned by the digital wallet. 25 char max
token_eligibility_decision string No The digital wallet's decision as to whether the digital wallet token should be provisioned. DECISION_RED | DECISION_YELLOW | DECISION_GREEN

The device object (response)

Name Type Required? Description Allowable Values
token string No The unique identifier of the device object. 36 char max
type string No The type of device being provisioned. MOBILE_PHONE |
WATCH |
TABLET |
MOBILE_PHONE_OR_TABLET |
VEHICLE |
APPLIANCE |
LAPTOP |
GAMING_DEVICE |
UNKNOWN
language_code string No The language the device is configured to use. 50 char max

For example: eng
device_id string No The identity number of the device. 20 char max
phone_number string No The device's telephone number. 50 char max
name string No The name of the device. 50 char max
location string No The geographic coordinates of the device. DDD.DD/DDD.DD

latitude/longitude

Note: Both the longitude and latitude are prefixed with either a "+" or "-" symbol, for example: +42.29/-71.07
ip_address string No The device's IP address. 50 char max (IP address format)

The wallet_provider_profile object (response)

Name Type Required? Description Allowable Values
account object No Contains information related to the card holder and provided by the digital wallet provider.
risk_assessment object No Contains the digital wallet provider's risk assessment for provisioning the digital wallet token.
device_score string No The score from the device. 50 char max
pan_source string No The source from which the digital wallet provider obtained the card PAN. KEY_ENTERED |
ON_FILE |
MOBILE_BANKING_APP

The wallet_provider_profile.account object (response)

Name Type Required? Description Allowable Values
id string No The wallet provider's identity number for the card holder. 20 char max
score string No The score from the digital wallet provider. 50 char max

The wallet_provider_profile.risk_assessment object (response)

Name Type Required? Description Allowable Values
score string No The wallet provider's decision as to whether the digital wallet token should be provisioned. DECISION_RED | DECISION_YELLOW | DECISION_GREEN

The address_verification object (response)

Name Type Required? Description Allowable Values
name string No The name of the card holder. 50 char max
street_address string No The street address of the card holder. 50 char max
zip string No The ZIP code of the card holder. 50 char max

Sample response

{
"token": "ccc47fa8-7730-4188-91f6-7214ba38b8f3",
"card_token": "platinum_grizzcard",
"state": "ACTIVE",
"state_reason": "",
"fulfillment_status": "PROVISIONED",
"issuer_eligibility_decision": "cardaccount.verified",
"created_time": "2016-10-03T18:55:45Z",
"last_modified_time": "2017-01-26T22:36:10Z",
"token_service_provider": {
"token_reference_id": "DNITHE381627769134881600",
"pan_reference_id": "V-3806261653021975990073",
"token_requestor_id": "40010020373",
"token_requestor_name": "",
"token_type": "DEVICE_SECURE_ELEMENT",
"token_score": "02",
"token_eligibility_decision": "DECISION_GREEN"
},
"device": {
"type": "MOBILE_PHONE",
"language_code": "eng",
"device_id": "045632E32F25800141612033439308035B57A7954FD29575",
"phone_number": "67595237333",
"name": "April Phone",
"location": "+37.81/-122.26",
"ip_address": "013.002.136.004"
},
"wallet_provider_profile": {
"account": {
"score": "05"
},
"risk_assessment": {
"score": "DECISION_YELLOW",
"version": "0001.00"
},
"device_score": "03",
"pan_source": "KEY_ENTERED",
"reason_code": "03"
},
"address_verification": {
"name": "",
"street_address": "223 Elm Street",
"zip": "94703"
}
}


List digital wallet tokens for card

Action: GET
Endpoint: /digitalwallettokens/card/{card_token}

To return an array of all digital wallet tokens for a particular card, issue a GET request to the /digitalwallettokens/card/{card_token} endpoint. Include the card token as a URL path parameter.

This endpoint supports pagination.

URL path parameters

Name Type Required? Description Allowable Values
card_token string Yes Identifies the card whose digital wallet tokens you want to list. Existing card token.

Issue a GET to /cards/user/{user_token} to retrieve card tokens for a specific user.

Sample response

{
"count": 1,
"start_index": 0,
"end_index": 0,
"is_more": true,
"data": [
{
"token": "ccc47fa8-7730-4188-91f6-7214ba38b8f3",
"card_token": "platinum_grizzcard",
"state": "ACTIVE",
"state_reason": "",
"fulfillment_status": "PROVISIONED",
"issuer_eligibility_decision": "cardaccount.verified",
"created_time": "2016-10-03T18:55:45Z",
"last_modified_time": "2017-01-26T22:36:10Z",
"token_service_provider": {
"token_reference_id": "DNITHE381627769134881600",
"pan_reference_id": "V-3806261653021975990073",
"token_requestor_id": "40010020373",
"token_requestor_name": "",
"token_type": "DEVICE_SECURE_ELEMENT",
"token_score": "02",
"token_eligibility_decision": "DECISION_GREEN"
},
"device": {
"type": "MOBILE_PHONE",
"language_code": "eng",
"device_id": "045632E32F25800141612033439308035B57A7954FD29575",
"phone_number": "67595237333",
"name": "April Phone",
"location": "+37.81/-122.26",
"ip_address": "013.002.136.004"
},
"wallet_provider_profile": {
"account": {
"score": "05"
},
"risk_assessment": {
"score": "DECISION_YELLOW",
"version": "0001.00"
},
"device_score": "03",
"pan_source": "KEY_ENTERED",
"reason_code": "03"
},
"address_verification": {
"name": "",
"street_address": "223 Elm Street",
"zip": "94703"
}
}
]
}


Retrieve digital wallet token PAN

Action: GET
Endpoint: /digitalwallettokens/{token}/showtokenpan

To retrieve a digital wallet token with the entire PAN displayed, send a GET request to the /digitalwallettokens/{digital_wallet_token_token}/showtokenpan endpoint. (For security reasons the PAN is not fully visible on the digital wallet token returned by GET /digitalwallettokens/{token}.) Include the token path parameter to specify the digital wallet token to return.

Note: The PAN returned is of the digital wallet token and not of the card.

URL path parameters

Name Type Required? Description Allowable Values
token string Yes The token identifying the digital wallet token to retrieve. Existing digital wallet token token.

Issue a GET to /digitalwallettokens/card/{card_token} to retrieve digital wallet token tokens for a particular card.

Sample response

{
"token": "ccc47fa8-7730-4188-91f6-7214ba38b8f3",
"card_token": "platinum_grizzcard",
"state": "ACTIVE",
"state_reason": "",
"fulfillment_status": "PROVISIONED",
"issuer_eligibility_decision": "cardaccount.verified",
"created_time": "2016-10-03T18:55:45Z",
"last_modified_time": "2017-01-26T22:36:10Z",
"token_service_provider": {
"token_reference_id": "DNITHE381627769134881600",
"pan_reference_id": "V-3806261653021975990073",
"token_requestor_id": "40010020373",
"token_requestor_name": "",
"token_type": "DEVICE_SECURE_ELEMENT",
"token_pan": "3829071483456792",
"token_score": "02",
"token_eligibility_decision": "DECISION_GREEN"
},
"device": {
"type": "MOBILE_PHONE",
"language_code": "eng",
"device_id": "045632E32F25800141612033439308035B57A7954FD29575",
"phone_number": "67595237333",
"name": "April Phone",
"location": "+37.81/-122.26",
"ip_address": "013.002.136.004"
},
"wallet_provider_profile": {
"account": {
"score": "05"
},
"risk_assessment": {
"score": "DECISION_YELLOW",
"version": "0001.00"
},
"device_score": "03",
"pan_source": "KEY_ENTERED",
"reason_code": "03"
},
"address_verification": {
"name": "",
"street_address": "223 Elm Street",
"zip": "94703"
}
}