Core API — Digital Wallets Management

naftiko: 1.0.0-alpha2
info:
  label: Core API — Digital Wallets Management
  description: 'Core API — Digital Wallets Management. 44 operations. Lead operation: Create digital wallet token provisioning
    request for Google Wallet. Self-contained Naftiko capability covering one Marqeta business surface.'
  tags:
  - Marqeta
  - Digital Wallets Management
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MARQETA_API_KEY: MARQETA_API_KEY
capability:
  consumes:
  - type: http
    namespace: core-digital-wallets-management
    baseUri: ''
    description: Core API — Digital Wallets Management business capability. Self-contained, no shared references.
    resources:
    - name: digitalwalletprovisionrequests-androidpay
      path: /digitalwalletprovisionrequests/androidpay
      operations:
      - name: postdigitalwalletprovisionrequestsandroidpay
        method: POST
        description: Create digital wallet token provisioning request for Google Wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: digitalwalletprovisionrequests-applepay
      path: /digitalwalletprovisionrequests/applepay
      operations:
      - name: postdigitalwalletprovisionrequestsapplepay
        method: POST
        description: Create digital wallet token provisioning request for Apple Wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: digitalwalletprovisionrequests-samsungpay
      path: /digitalwalletprovisionrequests/samsungpay
      operations:
      - name: postdigitalwalletprovisionrequestssamsungpay
        method: POST
        description: Create digital wallet token provisioning request for Samsung Wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: digitalwalletprovisionrequests-xpay
      path: /digitalwalletprovisionrequests/xpay
      operations:
      - name: postdigitalwalletprovisionrequestsxpay
        method: POST
        description: Create digital wallet token provisioning request for XPay
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: digitalwallets-aliasdirectory-visa-additionalAliases-additionalAliasId
      path: /digitalwallets/aliasdirectory/visa/additionalAliases/{additionalAliasId}
      operations:
      - name: deleteadditionalaliasbyid
        method: DELETE
        description: Delete an additional Visa Alias
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: additionalAliasId
          in: path
          type: string
          description: Unique identifier of the additional Visa Aliases.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
    - name: digitalwallets-aliasdirectory-visa-aliases
      path: /digitalwallets/aliasdirectory/visa/aliases
      operations:
      - name: createalias
        method: POST
        description: Create a Visa Alias
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-aliases-aliasId
      path: /digitalwallets/aliasdirectory/visa/aliases/aliasId
      operations:
      - name: getaliasidbyvalue
        method: POST
        description: Retrieve alias internal ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-aliases-getByExternalId
      path: /digitalwallets/aliasdirectory/visa/aliases/getByExternalId
      operations:
      - name: getaliasbyexternalid
        method: POST
        description: Retrieve Visa Alias by external ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-aliases-inquiry
      path: /digitalwallets/aliasdirectory/visa/aliases/inquiry
      operations:
      - name: inquirealiasavailability
        method: POST
        description: Check for Visa Alias
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-aliases-resolve
      path: /digitalwallets/aliasdirectory/visa/aliases/resolve
      operations:
      - name: resolvealias
        method: POST
        description: Resolve a Visa Alias
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-aliases-aliasId
      path: /digitalwallets/aliasdirectory/visa/aliases/{aliasId}
      operations:
      - name: deletealiasbyid
        method: DELETE
        description: Delete Visa Alias by Visa Alias ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: aliasId
          in: path
          type: string
          description: Unique identifier of the Visa Alias.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
      - name: getaliasbyid
        method: GET
        description: Retrieve Visa Alias by Visa Alias ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: aliasId
          in: path
          type: string
          description: Unique identifier of the Visa Alias.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
      - name: updatealiasbyid
        method: PUT
        description: Update Visa Alias by Visa Alias ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: aliasId
          in: path
          type: string
          description: Unique identifier of the Visa Alias.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-aliases-aliasId-additionalAlias
      path: /digitalwallets/aliasdirectory/visa/aliases/{aliasId}/additionalAlias
      operations:
      - name: createadditionalaliases
        method: POST
        description: Create an additional Visa Alias
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: aliasId
          in: path
          type: string
          description: Unique identifier of the Visa Alias.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-aliases-aliasId-cards
      path: /digitalwallets/aliasdirectory/visa/aliases/{aliasId}/cards
      operations:
      - name: getcardsbyalias
        method: GET
        description: Retrieve a Visa Alias payment credentials
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: aliasId
          in: path
          type: string
          description: Unique identifier of the Visa Alias.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
      - name: createcardbyalias
        method: POST
        description: Create Visa Alias payment credential
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: aliasId
          in: path
          type: string
          description: Unique identifier of the Visa Alias.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-aliases-aliasId-status
      path: /digitalwallets/aliasdirectory/visa/aliases/{aliasId}/status
      operations:
      - name: updatealiasstatus
        method: PUT
        description: Update alias status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: aliasId
          in: path
          type: string
          description: Unique identifier of the Visa Alias.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-cards-paymentCredentialId
      path: /digitalwallets/aliasdirectory/visa/cards/{paymentCredentialId}
      operations:
      - name: deletepaymentcredential
        method: DELETE
        description: Delete an existing payment credential
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: paymentCredentialId
          in: path
          type: string
          description: Unique identifier of an existing payment credential.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
      - name: getcardbycardtoken
        method: GET
        description: Retrieve payment credential
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: paymentCredentialId
          in: path
          type: string
          description: Unique identifier of an existing payment credential.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
      - name: updatepaymentcredential
        method: PUT
        description: Update payment credential
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: paymentCredentialId
          in: path
          type: string
          description: Unique identifier of an existing payment credential.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-reports
      path: /digitalwallets/aliasdirectory/visa/reports
      operations:
      - name: createreport
        method: POST
        description: Create a report request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-aliasdirectory-visa-reports-reportId
      path: /digitalwallets/aliasdirectory/visa/reports/{reportId}
      operations:
      - name: getreportbyid
        method: GET
        description: Retrieve report status by report ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reportId
          in: path
          type: string
          description: Unique identifier of the report.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
    - name: digitalwallets-aliasdirectory-visa-reports-reportId-file-fileId
      path: /digitalwallets/aliasdirectory/visa/reports/{reportId}/file/{fileId}
      operations:
      - name: getfilebyreportandfileid
        method: GET
        description: Retrieve file by file ID and report ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reportId
          in: path
          type: string
          description: Unique identifier of the report.
          required: true
        - name: fileId
          in: path
          type: string
          description: Unique identifier of the file.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: participant-id
          in: header
          type: string
          description: Visa Business Identifier (BID) that is assigned to the program.
          required: true
    - name: digitalwallets-clicktopay-mastercard-checkeligibility
      path: /digitalwallets/clicktopay/mastercard/checkeligibility
      operations:
      - name: getclicktopaymastercardcheckeligibility
        method: GET
        description: Check eligibility for Click to Pay for Mastercard
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: bin_prefix
          in: query
          type: string
          description: Prefix of the bank identification number.
          required: true
        - name: include_asset
          in: query
          type: boolean
          description: Returns a list of image assets for the Click to Pay logo if set to `true`.
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
    - name: digitalwallets-clicktopay-mastercard-enroll
      path: /digitalwallets/clicktopay/mastercard/enroll
      operations:
      - name: postclicktopaymastercardenroll
        method: POST
        description: Enroll a card to Click to Pay for Mastercard
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-clicktopay-mastercard-status-token
      path: /digitalwallets/clicktopay/mastercard/status/{token}
      operations:
      - name: getclicktopaymastercardstatustoken
        method: GET
        description: Retrieve Click to Pay for Mastercard enrollment status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: path
          type: string
          description: Unique identifier of the Click to Pay request.
          required: true
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
    - name: digitalwallets-clicktopay-visa-cards
      path: /digitalwallets/clicktopay/visa/cards
      operations:
      - name: updatecardinfo
        method: PUT
        description: Update card information for Click to Pay for Visa
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: external-consumer-id-owner-bid
          in: header
          type: string
          description: Visa Business Identifier (BID) of the entity to which an External Consumer ID belongs.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-clicktopay-visa-cards-card_token
      path: /digitalwallets/clicktopay/visa/cards/{card_token}
      operations:
      - name: deletecardinfo
        method: DELETE
        description: Delete card information for Click to Pay for Visa
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: external-consumer-id-owner-bid
          in: header
          type: string
          description: Visa Business Identifier (BID) of the entity to which an External Consumer ID belongs.
          required: true
        - name: card_token
          in: path
          type: string
          description: Unique identifier of the cardholder.
          required: true
    - name: digitalwallets-clicktopay-visa-enroll
      path: /digitalwallets/clicktopay/visa/enroll
      operations:
      - name: enrollcardholder
        method: POST
        description: Enroll a cardholder to Click to Pay for Visa
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: external-consumer-id-owner-bid
          in: header
          type: string
          description: Visa Business Identifier (BID) of the entity to which an External Consumer ID belongs.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-clicktopay-visa-enrollcards
      path: /digitalwallets/clicktopay/visa/enrollcards
      operations:
      - name: enrollcard
        method: POST
        description: Enroll a card to Click to Pay for Visa
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: external-consumer-id-owner-bid
          in: header
          type: string
          description: Visa Business Identifier (BID) of the entity to which an External Consumer ID belongs.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-clicktopay-visa-getdata-user_token
      path: /digitalwallets/clicktopay/visa/getdata/{user_token}
      operations:
      - name: getuserdata
        method: GET
        description: Retrieve user data for Click to Pay for Visa
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: user_token
          in: path
          type: string
          description: Unique identifier of the cardholder.
          required: true
        - name: external-consumer-id-owner-bid
          in: header
          type: string
          description: Visa Business Identifier (BID) of the entity to which an External Consumer ID belongs.
          required: true
    - name: digitalwallets-clicktopay-visa-status-requestTraceId
      path: /digitalwallets/clicktopay/visa/status/{requestTraceId}
      operations:
      - name: getstatus
        method: GET
        description: Retrieve Click to Pay for Visa request status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: requestTraceId
          in: path
          type: string
          description: Unique identifier of the Visa Click to Pay request.
          required: true
        - name: external-consumer-id-owner-bid
          in: header
          type: string
          description: Visa Business Identifier (BID) of the entity to which an External Consumer ID belongs.
          required: true
    - name: digitalwallets-clicktopay-visa-users
      path: /digitalwallets/clicktopay/visa/users
      operations:
      - name: deletecardholderinfo
        method: DELETE
        description: Delete cardholder information for Click to Pay for Visa
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
      - name: updatecardholderinfo
        method: PUT
        description: Update cardholder information for Click to Pay for Visa
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: external-consumer-id-owner-bid
          in: header
          type: string
          description: Visa Business Identifier (BID) of the entity to which an External Consumer ID belongs.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-postTokenizationAuthenticationDecision
      path: /digitalwallets/postTokenizationAuthenticationDecision
      operations:
      - name: posttokenizationauthenticationdecision
        method: POST
        description: Submit a post-tokenization authentication decision
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-wpp-applePayJWT
      path: /digitalwallets/wpp/applePayJWT
      operations:
      - name: generateapplepaywppjwt
        method: POST
        description: Create request for Apple Wallet web push provisioning
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallets-wpp-googlePayPushProvisioningNotification
      path: /digitalwallets/wpp/googlePayPushProvisioningNotification
      operations:
      - name: sendopcdatatogooglepay
        method: POST
        description: Create request for Google Wallet web push provisioning
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: req-sys-id
          in: header
          type: string
          description: Identifier generated by the card program.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: digitalwallettokens
      path: /digitalwallettokens
      operations:
      - name: getdigitalwallettokens
        method: GET
        description: List digital wallet tokens
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: count
          in: query
          type: integer
          description: Number of digital wallet token resources to retrieve.
        - name: start_index
          in: query
          type: integer
          description: Sort order index of the first digital wallet token resource in the returned array.
        - name: fields
          in: query
          type: string
          description: Comma-delimited list of fields to return (`field_1,field_2`, and so on).
        - name: sort_by
          in: query
          type: string
          description: Field on which to sort.
        - name: start_date
          in: query
          type: string
          description: Date when the digital wallet token becomes active.
        - name: end_date
          in: query
          type: string
          description: Expiration date of the digital wallet token.
        - name: pan

# --- truncated at 32 KB (82 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/marqeta/refs/heads/main/capabilities/core-digital-wallets-management.yaml