Marqeta Digital Wallets Management API

// Conditional snippet for beta or internal content include::../../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 >.

OpenAPI Specification

marqeta-digital-wallets-management-api-openapi.yml Raw ↑
openapi: 3.0.3
info:
  contact:
    email: support@marqeta.com
    name: Marqeta
  description: Marqeta's Core API endpoints, conveniently annotated to enable code generation (including SDKs), test cases, and documentation. Currently in beta.
  termsOfService: https://www.marqeta.com/api-terms
  title: Core accepted countries Digital Wallets Management API
  version: 3.0.39
servers:
- url: /v3
security:
- mqAppAndAccessToken: []
tags:
- description: '// Conditional snippet for beta or internal content

    include::../../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 <</developer-guides/digital-wallets-and-tokenization, Digital Wallets and Tokenization>>.'
  name: Digital Wallets Management
paths:
  /digitalwalletprovisionrequests/androidpay:
    post:
      description: 'Use this endpoint to return card data for use in provisioning a digital wallet token into Google Wallet.


        The returned card data is encrypted using the digital wallet provider''s encryption key, thereby reducing your PCI compliance overhead.'
      operationId: postDigitalwalletprovisionrequestsAndroidpay
      requestBody:
        content:
          application/json:
            example:
              card_token: my_card_token_0987
              device_id: my_device_id_r51j
              device_type: MOBILE_PHONE
              provisioning_app_version: 2.13.3
              wallet_account_id: my_wallet_account_id_sr51
            schema:
              $ref: '#/components/schemas/digital_wallet_android_pay_provision_request'
        required: false
      responses:
        '201':
          content:
            application/json:
              example:
                card_token: my_card_token_1111
                created_time: 2024-11-06 22:43:20+00:00
                last_modified_time: 2024-11-06 22:43:20+00:00
                push_tokenize_request_data:
                  display_name: Visa Card
                  last_digits: '3264'
                  network: Visa
                  opaque_payment_card: my_opaque_payment_card_RUza...
                  token_service_provider: TOKEN_PROVIDER_VISA
                  user_address:
                    address1: 180 Grand Ave
                    address2: Suite 500
                    city: Oakland
                    country: US
                    name: John Doe
                    phone: '5105551212'
                    postal_code: '94612'
                    state: CA
              schema:
                $ref: '#/components/schemas/digital_wallet_android_pay_provision_response'
          description: Success
        '400':
          content: {}
          description: User input error/Bad request
        '404':
          content: {}
          description: Card not found
        '500':
          content: {}
          description: Server error
      summary: Create digital wallet token provisioning request for Google Wallet
      tags:
      - Digital Wallets Management
  /digitalwalletprovisionrequests/applepay:
    post:
      description: 'Use this endpoint to return card data for use in provisioning a digital wallet token into Apple Wallet.


        The returned card data is encrypted using the digital wallet provider''s encryption key, thereby reducing your PCI compliance overhead.'
      operationId: postDigitalwalletprovisionrequestsApplepay
      requestBody:
        content:
          application/json:
            example:
              card_token: my_card_token_1234
              certificates:
              - my_certificate_ZIzj...
              - my_certificate_SgMA...
              device_type: MOBILE_PHONE
              nonce: my_nonce_JJCF
              nonce_signature: my_nonce_signature_wbBn
              provisioning_app_version: 2.13.7
            schema:
              $ref: '#/components/schemas/digital_wallet_apple_pay_provision_request'
        required: false
      responses:
        '201':
          content:
            application/json:
              example:
                activation_data: my_activation_data_VERF...
                card_token: my_card_token_1234
                created_time: 2025-03-22 21:22:19+00:00
                encrypted_pass_data: my_encrypted_pass_data_KGga...
                ephemeral_public_key: my_ephemeral_public_key_omvw...
                last_modified_time: 2025-03-22 21:22:19+00:00
              schema:
                $ref: '#/components/schemas/digital_wallet_apple_pay_provision_response'
          description: Success
        '400':
          content: {}
          description: User input error/Bad request
        '404':
          content: {}
          description: Card not found
        '500':
          content: {}
          description: Server error
      summary: Create digital wallet token provisioning request for Apple Wallet
      tags:
      - Digital Wallets Management
  /digitalwalletprovisionrequests/samsungpay:
    post:
      description: '[NOTE]

        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 Samsung Wallet.


        The returned card data is encrypted using the digital wallet provider''s encryption key, thereby reducing your PCI compliance overhead.'
      operationId: postDigitalwalletprovisionrequestsSamsungpay
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/digital_wallet_samsung_pay_provision_request'
        required: false
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/digital_wallet_samsung_pay_provision_response'
          description: Success
        '400':
          content: {}
          description: User input error/Bad request
        '404':
          content: {}
          description: Card not found
        '500':
          content: {}
          description: Server error
      summary: Create digital wallet token provisioning request for Samsung Wallet
      tags:
      - Digital Wallets Management
  /digitalwalletprovisionrequests/xpay:
    post:
      description: '[NOTE]

        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 PCI compliance overhead.'
      operationId: postDigitalwalletprovisionrequestsXPay
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/digital_wallet_x_pay_provision_request'
        required: false
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/digital_wallet_x_pay_provision_response'
          description: Success
        '400':
          content: {}
          description: User input error/Bad request
        '404':
          content: {}
          description: Card not found
        '500':
          content: {}
          description: Server error
      summary: Create digital wallet token provisioning request for XPay
      tags:
      - Digital Wallets Management
  /digitalwallets/aliasdirectory/visa/additionalAliases/{additionalAliasId}:
    delete:
      description: Use this endpoint to delete an additional Visa Alias by its Visa Alias ID.
      operationId: deleteAdditionalAliasById
      parameters:
      - description: Unique identifier of the additional Visa Aliases.
        example: a44c9553-e687-4f3c-b7e7-a4245d9f238e
        explode: false
        in: path
        name: additionalAliasId
        required: true
        schema:
          type: string
          x-allowableValues: Existing additional Visa Alias ID
        style: simple
      - description: 'Identifier generated by the card program.

          These identifiers are used for troubleshooting requests between the card program and Marqeta.'
        explode: false
        in: header
        name: req-sys-id
        required: true
        schema:
          type: string
        style: simple
      - description: Visa Business Identifier (BID) that is assigned to the program.
        example: '123456789001'
        explode: false
        in: header
        name: participant-id
        required: true
        schema:
          type: string
        style: simple
      responses:
        '204':
          description: Success
        '404':
          description: Not found
        '500':
          description: Internal server error
      summary: Delete an additional Visa Alias
      tags:
      - Digital Wallets Management
  /digitalwallets/aliasdirectory/visa/aliases:
    post:
      description: Use this endpoint to create a Visa Alias.
      operationId: createAlias
      parameters:
      - description: 'Identifier generated by the card program.

          These identifiers are used for troubleshooting requests between the card program and Marqeta.'
        explode: false
        in: header
        name: req-sys-id
        required: true
        schema:
          type: string
        style: simple
      - description: Visa Business Identifier (BID) that is assigned to the program.
        example: '123456789001'
        explode: false
        in: header
        name: participant-id
        required: true
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            example:
              aliasType: PHONE
              aliasValue: '1231231234'
              consent:
                expiryDateTime: 2027-06-20 10:00:00+00:00
                intermediaries:
                - Client A
                presenter: Bank A
                validFromDateTime: 2024-12-01 10:00:00+00:00
                version: '1.0'
              identification:
                type: PASSPORT
                value: A123456
                verificationDetails:
                  authDateTime: 2025-01-01 22:52:46+00:00
                  authMethodReference: EXTERNAL, SMS OTP, Email OTP
                  creationDateTime: 2025-01-01 22:52:46+00:00
                  verifiedEmail: true
                  verifiedPhone: false
              paymentCredentials:
              - billingAddress:
                  addressLine1: 1000 Market Street
                  addressLine2: Suite 101
                  buildingNumber: '56'
                  city: San Francisco
                  country: USA
                  minorSubdivisionCode: CA
                  postalCode: '94105'
                  state: CA
                  streetName: '12'
                cardToken: '4111111145551142'
                cardType: Visa Platinum
                currencyCode: USD
                issuerName: Bank A
                nameOnCard: John Doe
              profile:
                contactInfo:
                - type: PHONE
                  value: '1231234321'
                dateOfBirth: 1980-02-01
                firstName: Alex
                firstNameLocal: Roberto
                lastName: Miller
                lastNameLocal: Miller
                middleName: Robert
                middleNameLocal: Alexander
                preferredName: Miller's Shop
              userToken: 21267931-7975-4b61-be7a-86915883b2b4
            schema:
              $ref: '#/components/schemas/ads_create_alias_request'
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                externalId: 21267931-7975-4b61-a-8691588sdfsdfa
                id: 1f4f5e10-bde6-46a7-b2aa-576550054981
                paymentCredentials:
                - externalId: '1111111111111111'
                  id: 19e538ea-edfb-4780-915e-2f6e02959e03
                  type: CARD
              schema:
                $ref: '#/components/schemas/ads_create_alias_response'
          description: Success
        '400':
          description: User input error/Bad request
        '422':
          description: Unprocessable entity
        '500':
          description: Internal server error
      summary: Create a Visa Alias
      tags:
      - Digital Wallets Management
  /digitalwallets/aliasdirectory/visa/aliases/aliasId:
    post:
      description: Use this endpoint to retrieve the internal ID associated with a Visa Alias.
      operationId: getAliasIdByValue
      parameters:
      - description: 'Identifier generated by the card program.

          These identifiers are used for troubleshooting requests between the card program and Marqeta.'
        explode: false
        in: header
        name: req-sys-id
        required: true
        schema:
          type: string
        style: simple
      - description: Visa Business Identifier (BID) that is assigned to the program.
        example: '123456789001'
        explode: false
        in: header
        name: participant-id
        required: true
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            example:
              aliasValue: my_alias_value_1234
            schema:
              properties:
                aliasValue:
                  description: 'Visa Alias value, which can be an email, a phone number, ID of an alias directory, or a payname.


                    If a phone number is used for the Visa Alias, it must follow ITU-T E.164 (2010) number structure.

                    *NOTE:* In the E.164 format, the "+" sign is not included.'
                  maxLength: 128
                  minLength: 1
                  type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                id: my_alias_id_1234
              schema:
                properties:
                  id:
                    description: UUID generated by Alias Directory, which identifies the Visa Alias.
                    maxLength: 128
                    minLength: 1
                    type: string
          description: Success
        '400':
          description: User input error/Bad request
        '404':
          description: Not found
        '500':
          description: Internal server error
      summary: Retrieve alias internal ID
      tags:
      - Digital Wallets Management
  /digitalwallets/aliasdirectory/visa/aliases/getByExternalId:
    post:
      description: Use this endpoint to retrieve a Visa Alias by its external ID.
      operationId: getAliasByExternalId
      parameters:
      - description: 'Identifier generated by the card program.

          These identifiers are used for troubleshooting requests between the card program and Marqeta.'
        explode: false
        in: header
        name: req-sys-id
        required: true
        schema:
          type: string
        style: simple
      - description: Visa Business Identifier (BID) that is assigned to the program.
        example: '123456789001'
        explode: false
        in: header
        name: participant-id
        required: true
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            example:
              externalId: 21267931-7975-4b61-be7a-86915883b2b4
              type: ALIAS
            schema:
              $ref: '#/components/schemas/ads_get_by_external_id_request'
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                associatedIds:
                - id: a44c9553-e687-4f3c-b7e7-a4245d9f238e
                  type: PAYMENT_CREDENTIAL
                id: e336c8c8-2945-4be3-af3e-951ec2d01219
              schema:
                $ref: '#/components/schemas/ads_get_by_external_id_response'
          description: Success
        '400':
          description: User input error/Bad request
        '404':
          description: Not found
        '500':
          description: Internal server error
      summary: Retrieve Visa Alias by external ID
      tags:
      - Digital Wallets Management
  /digitalwallets/aliasdirectory/visa/aliases/inquiry:
    post:
      description: 'Use this endpoint to check for available Visa Aliases for alias resolution.

        One or more Visa Aliases may be available.'
      operationId: inquireAliasAvailability
      parameters:
      - description: Visa Business Identifier (BID) that is assigned to the program.
        example: '123456789001'
        explode: false
        in: header
        name: participant-id
        required: true
        schema:
          type: string
        style: simple
      - description: 'Identifier generated by the card program.

          These identifiers are used for troubleshooting requests between the card program and Marqeta.'
        explode: false
        in: header
        name: req-sys-id
        required: true
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            example:
              aliases:
              - '123456'
              filters:
              - field: DIRECTORY_NAME
                value:
                - DIRECTORY_A
                - DIRECTORY_B
                - DIRECTORY_C
              transactionDetails:
                currencyCode: USD
              userDetails:
                userName: johndoe313
            schema:
              $ref: '#/components/schemas/ads_alias_inquiry_request'
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
              - details:
                - aliasType: PHONE
                  aliasValue: '123456'
                  directories:
                  - directoryName: DIRECTORY_A
                    entities:
                    - id: '1101'
                    - id: '1102'
                      preferredFor:
                      - date: 1980-02-01
                        type: RECEIVE
                  - directoryName: DIRECTORY_B
                  directoriesName:
                  - DIRECTORY_A
                  - DIRECTORY_B
                summary:
                  aliasesFound: 1
                  aliasesNotFound: 0
                  aliasesRepeated: 0
                  aliasesTotal: 1
              schema:
                items:
                  $ref: '#/components/schemas/ads_alias_inquiry_response'
                type: array
          description: Success
        '400':
          description: User input error/Bad request
        '404':
          description: Not found
        '500':
          description: Internal server error
      summary: Check for Visa Alias
      tags:
      - Digital Wallets Management
  /digitalwallets/aliasdirectory/visa/aliases/resolve:
    post:
      description: Retrieve information about a Visa Alias and all the associated payment credentials.
      operationId: resolveAlias
      parameters:
      - description: Visa Business Identifier (BID) that is assigned to the program.
        example: '123456789001'
        explode: false
        in: header
        name: participant-id
        required: true
        schema:
          type: string
        style: simple
      - description: 'Identifier generated by the card program.

          These identifiers are used for troubleshooting requests between the card program and Marqeta.'
        explode: false
        in: header
        name: req-sys-id
        required: true
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            example:
              aliasType: PHONE
              aliasValue: '1231231234'
              filters:
              - field: DIRECTORY_NAME
                value:
                - DIRECTORY_A
                - DIRECTORY_B
                - DIRECTORY_C
              transactionDetails:
                currencyCode: USD
              userDetails:
                userName: username1234
            schema:
              $ref: '#/components/schemas/ads_alias_resolve_request'
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
              - directoryName: DIRECTORY_A
                identification:
                  type: PASSPORT
                  value: A123456
                  verificationDetails:
                    authDateTime: 2021-01-01 22:52:46+00:00
                    authMethodReference: EXTERNAL, SMS OTP, Email OTP
                    creationDateTime: 2021-01-01 22:52:46+00:00
                    verifiedEmail: true
                    verifiedPhone: false
                paymentCredentials:
                - accountNumber: '4111111145551142'
                  accountNumberType: TOKEN
                  billingAddress:
                    addressLine1: 1000 Market Street
                    addressLine2: Suite 101
                    buildingNumber: '56'
                    city: San Francisco
                    country: USA
                    minorSubdivisionCode: CA
                    postalCode: '94105'
                    state: CA
                    streetName: '12'
                  cardType: Visa Platinum
                  currencyCode: USD
                  expirationDate: 2026-01
                  issuerName: Bank A
                  lastFourDigits: '1142'
                  modifiedOn: 2021-01-01 22:52:46+00:00
                  nameOnCard: Alex Miller
                  preferredFor:
                  - date: 2021-01-01
                    type: RECEIVE
                  type: CARD
                profile:
                  contactInfo:
                  - type: PHONE
                    value: '1231234321'
                  dateOfBirth: 1980-02-01
                  firstName: Alex
                  firstNameLocal: Alexander
                  lastName: Miller
                  lastNameLocal: Miller
                  middleName: Robert
                  middleNameLocal: Roberto
                  preferredName: Miller's Shop
              schema:
                items:
                  $ref: '#/components/schemas/ads_alias_resolve_response'
                type: array
          description: Success
        '400':
          description: User input error/Bad request
        '404':
          description: Not found
        '500':
          description: Internal server error
      summary: Resolve a Visa Alias
      tags:
      - Digital Wallets Management
  /digitalwallets/aliasdirectory/visa/aliases/{aliasId}:
    delete:
      description: Use this endpoint to delete a Visa Alias by Visa Alias ID.
      operationId: deleteAliasById
      parameters:
      - description: Unique identifier of the Visa Alias.
        example: a44c9553-e687-4f3c-b7e7-a4245d9f238e
        explode: false
        in: path
        name: aliasId
        required: true
        schema:
          type: string
          x-allowableValues: Existing Visa Alias ID
        style: simple
      - description: 'Identifier generated by the card program.

          These identifiers are used for troubleshooting requests between the card program and Marqeta.'
        explode: false
        in: header
        name: req-sys-id
        required: true
        schema:
          type: string
        style: simple
      - description: Visa Business Identifier (BID) that is assigned to the program.
        example: '123456789001'
        explode: false
        in: header
        name: participant-id
        required: true
        schema:
          type: string
        style: simple
      responses:
        '204':
          description: Success
        '404':
          description: Not found
        '500':
          description: Internal server error
      summary: Delete Visa Alias by Visa Alias ID
      tags:
      - Digital Wallets Management
    get:
      description: Use this endpoint to retrieve a Visa Alias by its Visa Alias ID.
      operationId: getAliasById
      parameters:
      - description: Unique identifier of the Visa Alias.
        explode: false
        in: path
        name: aliasId
        required: true
        schema:
          type: string
          x-allowableValues: Existing Visa Alias ID
        style: simple
      - description: 'Identifier generated by the card program.

          These identifiers are used for troubleshooting requests between the card program and Marqeta.'
        explode: false
        in: header
        name: req-sys-id
        required: true
        schema:
          type: string
        style: simple
      - description: Visa Business Identifier (BID) that is assigned to the program.
        example: '123456789001'
        explode: false
        in: header
        name: participant-id
        required: true
        schema:
          type: string
        style: simple
      responses:
        '200':
          content:
            application/json:
              example:
                aliasType: PHONE
                aliasValue: '1231231234'
                consent:
                  expiryDateTime: 2025-06-20 10:00:00+00:00
                  intermediaries:
                  - Client A
                  presenter: Bank A
                  validFromDateTime: 2024-12-01 10:00:00+00:00
                  version: '1.0'
                createdOn: 2025-01-01 22:52:46+00:00
                identification:
                  type: PASSPORT
                  value: A123456
                  verificationDetails:
                    authDateTime: 2025-01-01 22:52:46+00:00
                    authMethodReference: EXTERNAL, SMS OTP, Email OTP
                    creationDateTime: 2025-01-01 22:52:46+00:00
                    verifiedEmail: true
                    verifiedPhone: false
                lastModifiedOn: 2025-01-01 22:52:46+00:00
                profile:
                  contactInfo:
                  - type: PHONE
                    value: '1231234321'
                  dateOfBirth: 1980-02-01
                  firstName: Alex
                  firstNameLocal: Alexander
                  lastName: Miller
                  lastNameLocal: Miller
                  middleName: Robert
                  middleNameLocal: Roberto
                  preferredName: Miller's Shop
                status: ACTIVE
              schema:
                $ref: '#/components/schemas/ads_alias_response'
          description: Success
        '400':
          description: User input error/Bad request
        '404':
          description: Not found
        '500':
          description: Internal server error
      summary: Retrieve Visa Alias by Visa Alias ID
      tags:
      - Digital Wallets Management
    put:
      description: Use this endpoint to update a Visa Alias by its Visa Alias ID.
      operationId: updateAliasById
      parameters:
      - description: Unique identifier of the Visa Alias.
        explode: false
        in: path
        name: aliasId
        required: true
        schema:
          type: string
          x-allowableValues: Existing Visa Alias ID
        style: simple
      - description: 'Identifier generated by the card program.

          These identifiers are used for troubleshooting requests between the card program and Marqeta.'
        explode: false
        in: header
        name: req-sys-id
        required: true
        schema:
          type: string
        style: simple
      - description: Visa Business Identifier (BID) that is assigned to the program.
        example: '123456789001'
        explode: false
        in: header
        name: participant-id
        required: true
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            example:
              aliasType: PHONE
              aliasValue: '1231231234'
              consent:
                expiryDateTime: 2025-06-20 10:00:00+00:00
                intermediaries:
                - Client A
                presenter: Bank A
                validFromDateTime: 2024-12-01 10:00:00+00:00
                version: '1.0'
              createdOn: 2025-01-01 22:52:46+00:00
              identification:
                type: PASSPORT
                value: A123456
                verificationDetails:
                  authDateTime: 2025-01-01 22:52:46+00:00
                  authMethodReference: EXTERNAL, SMS OTP, Email OTP
                  creationDateTime: 2025-01-01 22:52:46+00:00
                  verifiedEmail: true
                  verifiedPhone: false
              lastModifiedOn: 2025-01-01 22:52:46+00:00
              profile:
                contactInfo:
                - type: PHONE
                  value: '1231234321'
                dateOfBirth: 1980-02-01
                firstName: Alex
                firstNameLocal: Alexander
                lastName: Miller
                lastNameLocal: Miller
                middleName: Robert
                middleNameLocal: Roberto
                preferredName: Miller's Shop
              status: ACTIVE
            schema:
              $ref: '#/components/schemas/ads_update_alias_request'
        required: true
      responses:
        '204':
          description: Success
        '400':
          description: User input error/Bad request
        '404':
          description: Not found
        '500':
          description: Internal server error
      summary: Update Visa Alias by Visa Alias ID
      tags:
      - Digital Wallets Management
  /digitalwallets/aliasdirectory/visa/aliases/{aliasId}/additionalAlias:
    post:
      description: Use this endpoint to create additional Visa Aliases associated with an existing main Visa Alias.
      operationId: createAdditionalAliases
      parameters:
      - description: Unique identifier of the Visa Alias.
        explode: false
        in: path
        name: aliasId
        required: true
        schema:
          type: string
          x-allowableValues: Existing Visa Alias ID
        style: simple
      - description: 'Identifier generated by the card program.

          These identifiers are used for troubleshooting requests between the card program and Marqeta.'
        explode: false
        in: header
        name: req-sys-id
        required: true
        schema:
          type: string
        style: simple
      - description: Visa Business Identifier (BID) that is assigned to the program.
        example: '123456789001'
        explode: false
        in: header
        name: participant-id
        required: true
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            example:
              type: EMAIL
              value: '1231231234'
            schema:
              $ref: '#/components/schemas/ads_create_additional_aliases_request'
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                id: my_alias_id_1234
              schema:
                $ref: '#/components/schemas/ads_create_additional_alias_response'
          description: Success
        '400':
          description: User input error/Bad request
        '422':
          description: Unprocessable entity
        '500':
          description: Internal server error
      summary: Create an additional Visa Alias
      tags:
      - Digital Wallets Management
  /digitalwallets/aliasdirectory/visa/aliases/{aliasId}/cards:
    get:
      description: Use this endpoint to retrieve a list of payment credentials associated with a Visa Alias.
      operationId: getCardsByAlias
      parameters:
      - description: Unique identifier of the Visa Alias.
        explode: false
        in: path
        name: aliasId
        required: true
        schema:
          type: string
          x-allowableValues: Existing Visa Alias ID
        style: simple
      - description: 'Identifier gener

# --- truncated at 32 KB (210 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/marqeta/refs/heads/main/openapi/marqeta-digital-wallets-management-api-openapi.yml