Marqeta Digital Wallets Management API
// Conditional snippet for beta or internal contentinclude::../../maturity-admonition-banner.adoc[]The Marqeta platform facilitates the use of digital wallets for storing tokenized cards and making payments.The API provides endpoints that enable mobile applications to provision tokens into a digital wallet.It also provides endpoints for retrieving digital wallet tokens and for managing their lifecycle through state transitions.For an overview of digital wallet tokens, see >.
Marqeta Digital Wallets Management API is one of 81 APIs that Marqeta publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Digital Wallets Management. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes 44 operations across 38 paths, and defines 96 schemas. It is described by OpenAPI 3.0.3, at version 3.0.39.
Requests are made against a single base URL, /v3.
44 operations
38 paths
96 schemas
5 DELETE15 GET19 POST5 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Marqeta Digital Wallets Management API declares
1 security scheme
for authenticating requests.
It accepts HTTP basic authentication (mqAppAndAccessToken).
By default, every request must be authenticated.
Paths & Operations 44
Across 38 paths, the API surfaces 44 operations — 5 DELETE, 15 GET, 19 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.
Digital Wallets Management 44
// Conditional snippet for beta or internal content include::../../maturity-admonition-banner.adoc[] The Marqeta platform facilitates the use of digital wallets for storing tokeni…
POST
/digitalwalletprovisionrequests/androidpay
Create digital wallet token provisioning request for Google Wallet
POST
/digitalwalletprovisionrequests/applepay
Create digital wallet token provisioning request for Apple Wallet
POST
/digitalwalletprovisionrequests/samsungpay
Create digital wallet token provisioning request for Samsung Wallet
POST
/digitalwalletprovisionrequests/xpay
Create digital wallet token provisioning request for XPay
DELETE
/digitalwallets/aliasdirectory/visa/additionalAliases/{additionalAliasId}
Delete an additional Visa Alias
POST
/digitalwallets/aliasdirectory/visa/aliases
Create a Visa Alias
POST
/digitalwallets/aliasdirectory/visa/aliases/aliasId
Retrieve alias internal ID
POST
/digitalwallets/aliasdirectory/visa/aliases/getByExternalId
Retrieve Visa Alias by external ID
POST
/digitalwallets/aliasdirectory/visa/aliases/inquiry
Check for Visa Alias
POST
/digitalwallets/aliasdirectory/visa/aliases/resolve
Resolve a Visa Alias
DELETE
/digitalwallets/aliasdirectory/visa/aliases/{aliasId}
Delete Visa Alias by Visa Alias ID
GET
/digitalwallets/aliasdirectory/visa/aliases/{aliasId}
Retrieve Visa Alias by Visa Alias ID
PUT
/digitalwallets/aliasdirectory/visa/aliases/{aliasId}
Update Visa Alias by Visa Alias ID
POST
/digitalwallets/aliasdirectory/visa/aliases/{aliasId}/additionalAlias
Create an additional Visa Alias
GET
/digitalwallets/aliasdirectory/visa/aliases/{aliasId}/cards
Retrieve a Visa Alias payment credentials
POST
/digitalwallets/aliasdirectory/visa/aliases/{aliasId}/cards
Create Visa Alias payment credential
PUT
/digitalwallets/aliasdirectory/visa/aliases/{aliasId}/status
Update alias status
DELETE
/digitalwallets/aliasdirectory/visa/cards/{paymentCredentialId}
Delete an existing payment credential
GET
/digitalwallets/aliasdirectory/visa/cards/{paymentCredentialId}
Retrieve payment credential
PUT
/digitalwallets/aliasdirectory/visa/cards/{paymentCredentialId}
Update payment credential
POST
/digitalwallets/aliasdirectory/visa/reports
Create a report request
GET
/digitalwallets/aliasdirectory/visa/reports/{reportId}
Retrieve report status by report ID
GET
/digitalwallets/aliasdirectory/visa/reports/{reportId}/file/{fileId}
Retrieve file by file ID and report ID
GET
/digitalwallets/clicktopay/mastercard/checkeligibility
Check eligibility for Click to Pay for Mastercard
POST
/digitalwallets/clicktopay/mastercard/enroll
Enroll a card to Click to Pay for Mastercard
GET
/digitalwallets/clicktopay/mastercard/status/{token}
Retrieve Click to Pay for Mastercard enrollment status
PUT
/digitalwallets/clicktopay/visa/cards
Update card information for Click to Pay for Visa
DELETE
/digitalwallets/clicktopay/visa/cards/{card_token}
Delete card information for Click to Pay for Visa
POST
/digitalwallets/clicktopay/visa/enroll
Enroll a cardholder to Click to Pay for Visa
POST
/digitalwallets/clicktopay/visa/enrollcards
Enroll a card to Click to Pay for Visa
GET
/digitalwallets/clicktopay/visa/getdata/{user_token}
Retrieve user data for Click to Pay for Visa
GET
/digitalwallets/clicktopay/visa/status/{requestTraceId}
Retrieve Click to Pay for Visa request status
DELETE
/digitalwallets/clicktopay/visa/users
Delete cardholder information for Click to Pay for Visa
PUT
/digitalwallets/clicktopay/visa/users
Update cardholder information for Click to Pay for Visa
POST
/digitalwallets/postTokenizationAuthenticationDecision
Submit a post-tokenization authentication decision
POST
/digitalwallets/wpp/applePayJWT
Create request for Apple Wallet web push provisioning
POST
/digitalwallets/wpp/googlePayPushProvisioningNotification
Create request for Google Wallet web push provisioning
GET
/digitalwallettokens
List digital wallet tokens
GET
/digitalwallettokens/card/{card_token}
List digital wallet tokens for card
GET
/digitalwallettokens/{token}
Retrieve digital wallet token
GET
/digitalwallettokens/{token}/showtokenpan
Retrieve digital wallet token PAN
POST
/digitalwallettokentransitions
Create digital wallet token transition
GET
/digitalwallettokentransitions/digitalwallettoken/{token}
List transitions for digital wallet token
GET
/digitalwallettokentransitions/{token}
Retrieve digital wallet token transition
Schemas 96
The contract defines 96 schemas that model the data the API accepts and returns. The most detailed are user_card_holder_response (40 properties), ads_card_response (16 properties), digital_wallet_token (15 properties), token_service_provider (12 properties). Each schema is shown below with its type and property counts.
ads_create_card_details_response
object
Response containing the payment credential associated with a Visa ADS alias.
3 properties
2 required
click_to_pay_status_response
object
3 properties
transaction_device
object
Contains information about the device used in the transaction to enhance the risk decisioning process. Use this data to improve fraud prevention and dispute re…
4 properties
ads_preferred_for
object
Details of the operation.
2 properties
1 required
visa_click_to_pay_user
object
User's email address, mobile phone number without country code, first name, last name, locale, and country.
7 properties
7 required
click_to_pay_check_eligibility_response
object
2 properties
xpay_push_tokenize_request_data
object
Contains details about a card tokenization push request.
6 properties
web_push_provisioning_apple_pay_JWS_model
object
Object containing JSON Web Signature (JWS) data.
4 properties
4 required
ads_create_additional_aliases_request
object
Request to create an additional alias.
2 properties
2 required
risk_assessment
object
Contains the digital wallet provider's risk assessment for provisioning the digital wallet token.
2 properties
web_push_provisioning_apple_pay_JWS_header
object
Contains header data for the JWS object.
1 property
1 required
ads_get_report_status_response
object
Response containing the status of the report.
8 properties
ads_alias_inquiry_details
object
Visa Alias information associated with existing records.
4 properties
ads_consent
object
Visa Alias Directory Service (ADS) consent information.
5 properties
3 required
visa_click_to_pay_status_response
object
Response containing the status of a Visa Click to Pay request.
3 properties
1 required
ads_alias_inquiry_user_details
object
Details of the user requesting the Visa Alias information. The information must not contain personal identifiable information (PII).
1 property
DigitalWalletTokenListResponse
object
5 properties
ads_payment_credentials_response
object
Response containing the details of a payment credential.
3 properties
2 required
digital_wallet_android_pay_provision_request
object
5 properties
5 required
ads_verification_details
object
Verification details associated with the Visa Alias. This field is returned if it exists in the resource.
5 properties
visa_click_to_pay_response
object
Response containing the request trace ID of a Visa Click to Pay request.
1 property
1 required
ads_get_by_external_id_response
object
Response for retrieve by external ID request.
2 properties
1 required
digital_wallet_samsung_pay_provision_response
object
4 properties
4 required
digital_wallet_token_hash
object
Contains identifiers of the digital wallet token resource and the card resource.
2 properties
1 required
ads_card_details_request
object
Request object for creating or updating a Visa ADS card.
7 properties
5 required
PostTokenizationAuthenticationDecisionResponse
object
2 properties
2 required
ads_directory_object
object
Directory object associated with the Visa Alias.
2 properties
ads_create_alias_response
object
Response containing the unique identifier of the alias generated by Alias Directory.
3 properties
1 required
ads_alias_inquiry_response
object
Response object containing Visa Aliases available for alias resolution. One or more Visa Aliases maybe available.
2 properties
1 required
click_to_pay_enroll_response
object
1 property
AndroidPushTokenRequestAddress
object
Specifies the cardholder address.
9 properties
PostTokenizationAuthenticationDecisionRequest
object
5 properties
3 required
visa_click_to_pay_update_cardholder_request
object
Request to update cardholder information.
1 property
1 required
media_content
object
4 properties
address_verification
object
Contains address verification information.
4 properties
digital_wallet_token
object
Contains information about the digital wallet that funded the transaction. Returned for all transactions funded by a digital wallet or related to digital walle…
15 properties
visa_click_to_pay_payment_instrument
object
Object containing details of payment instruments for Visa Click to Pay.
8 properties
ads_contact_info
object
Contact information in the Alias Directory Service (ADS) profile. This array is returned if the Visa Alias' contact information details exist.
2 properties
2 required
digital_wallet_x_pay_provision_response
object
4 properties
4 required
digital_wallet_android_pay_provision_response
object
4 properties
4 required
visa_click_to_pay_user_data
object
Object containing user data.
3 properties
3 required
DigitalWalletTokenTransitionListResponse
object
5 properties
account
object
Contains information related to the cardholder and provided by the digital wallet provider.
3 properties
ads_associated_ids
object
Associated payment credential IDs.
2 properties
visa_click_to_pay_status_details
object
3 properties
3 required
ads_card_response
object
Response containing the payment credential associated with a Visa ADS alias.
16 properties
3 required
ads_entity
object
Information about the Visa ADS entities.
2 properties
IdentificationResponseModel
object
Contains identifications associated with the cardholder.
4 properties
sending_provisioning_data_to_google_pay_backend_request
object
8 properties
8 required
token_service_provider
object
Contains information held and provided by the token service provider (card network).
12 properties
1 required
user_card_holder_response
object
Contains information about a cardholder.
40 properties
2 required
visa_click_to_pay_billing_address
object
Billing address for Visa Click to Pay.
6 properties
1 required
visa_click_to_pay_card
object
Card information for Visa Click to Pay.
3 properties
3 required
click_to_pay_enroll_request
object
11 properties
5 required
visa_click_to_pay_consumer_information
object
Object containing cardholder details for Visa Click to Pay operation.
9 properties
click_to_pay_enroll_request_user_details
object
User's email address and mobile phone number with country code.
2 properties
2 required
ads_transaction_detail
object
Details of the transaction associated with the Alias.
1 property
digital_wallet_samsung_pay_provision_request
object
5 properties
5 required
digital_wallet_apple_pay_provision_request
object
6 properties
6 required
android_push_tokenize_request_data
object
Contains details about a card tokenization push request.
6 properties
ads_get_by_external_id_request
object
Request to get a Visa Alias by external ID.
2 properties
2 required
digital_wallet_apple_pay_provision_response
object
6 properties
6 required
visa_click_to_pay_intent
object
Intent of the Visa Click to Pay operation.
2 properties
2 required
ads_create_report_request
object
ADS create report request.
3 properties
3 required
digital_wallet_token_transition_request
object
7 properties
2 required
error_message_from_web_push_provisioning_request
object
2 properties
2 required
samsung_push_tokenize_request_data
object
Contains details about a card tokenization push request.
6 properties
ads_billing_address
object
Billing address for the payment credential.
9 properties
1 required
Authentication
object
Contains the cardholder's email address and password information.
4 properties
ads_profile
object
Alias Directory Service (ADS) profile information.
9 properties
2 required
ads_create_alias_request
object
7 properties
6 required
ads_alias_inquiry_summary
object
Summary of available Visa Aliases.
4 properties
4 required
visa_click_to_pay_get_user_data_response
object
Response containing the information of a Visa Click to Pay cardholder.
1 property
1 required
ads_create_additional_alias_response
object
Response containing the unique identifier of the additional alias generated by Alias Directory.
1 property
1 required
visa_click_to_pay_enroll_cards_request
object
Request to enroll a card for an existing cardholder.
2 properties
2 required
device
object
Contains information related to the device being provisioned.
8 properties
visa_click_to_pay_update_card_request
object
Request to update a card for an existing cardholder.
2 properties
2 required
ads_report_filters
object
Filters for the report.
5 properties
4 required
request_for_apple_pay_wpp_JWT
object
2 properties
1 required
ads_report_file_response
object
The response schema for the ADS report file.
5 properties
ads_cards_response
object
Response containing the payment credentials associated with a Visa Alias Directory Service (ADS) alias.
1 property
ads_alias_response
object
Visa Alias response object for retrieving information.
8 properties
wallet_provider_profile
object
Contains information held and provided by the digital wallet provider.
6 properties
visa_click_to_pay_enroll_request
object
Request to enroll a new cardholder and card.
2 properties
2 required
ads_alias_inquiry_filter
object
Field and/or value filter to check the availability of the Visa Alias.
2 properties
digital_wallet_x_pay_provision_request
object
6 properties
6 required
digital_wallet_token_metadata
object
Contains additional information about the digital wallet token.
2 properties
digital_wallet_token_transition_response
object
10 properties
6 required
ads_update_alias_request
object
Ads update alias request.
3 properties
2 required
ads_alias_inquiry_request
object
Request object that checks for Visa Aliases that are available for alias resolution. One or more Visa Aliases may be available.
4 properties
1 required
web_push_provisioning_apple_pay_JWT_response
object
2 properties
2 required
ads_alias_resolve_request
object
Request object to resolve one or more Visa Aliases.
5 properties
2 required
ads_alias_resolve_response
object
Response object to resolve one or more Visa Aliases.
4 properties
1 required
card_swap_hash
object
Contains identifiers for swapping digital wallet tokens between cards.
2 properties
2 required
ads_identification
object
Identification of the user associated with the Visa Alias.
3 properties
2 required
click_to_pay_enroll_request_user_mobile_number
object
User's mobile phone number and country code.
2 properties
2 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Marqeta 12
Other APIs Marqeta publishes across the network.
Marqeta Webhooks
Marqeta Risk Controller / Real-Time Decisioning
Marqeta accepted countries API
Marqeta Account API
Marqeta Account Bundle Transitions API
Marqeta Account Cards API
Marqeta Account Documents API
Marqeta account holder groups API
Marqeta Account Refunds API
Marqeta Account Rewards API
Marqeta Account Signup Bonus API
Marqeta Account Transitions API
#Digital Wallets Management
Where this information came from
This is an independent, third-party profile of Marqeta Digital Wallets Management API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.