List Payment Methods

The listPaymentMethods MCP tool lists all available Payment Methods for the customer

Response

Returns an MCP tool result containing a purchase intent object:

{
  "content": [
    {
      "type": "json",
      "json": [
  {
    "id": "26859380-7829-4ee1-8a0a-38927881e7ef",
    "type": "card",
    "entityId": "94c94330-94fd-4832-a106-e8474a274fe4",
    "card": {
      "type": "credit",
      "brand": "mastercard",
      "details": {
        "bin": "512035",
        "last4": "4594",
        "expirationMonth": "12",
        "expirationYear": "2025"
      },
      "display": {
        "artUrl": "https://sbx.assets.mastercard.com/card-art/combined-image-asset/6713d73d-a701-4bd2-bc9b-2e98940de9c7.png",
        "backgroundColor": "1A1F71",
        "foregroundColor": "000000",
        "description": "MasterCard Test Bank",
        "issuerName": "Test Issuer"
      }
    },
    "credentialTypes": ["network-token", "virtual-card", "pan"],
    "createdAt": "2025-06-16T14:00:00Z"
  },
  {
    "id": "26859380-7829-4ee1-8a0a-38927881e7ef",
    "type": "card", 
    "entityId": "94c94330-94fd-4832-a106-e8474a274fe4",
    "card": {
      "type": "credit",
      "brand": "visa",
      "details": {
        "bin": "424242",
        "last4": "4242",
        "expirationMonth": "12",
        "expirationYear": "2025"
      },
      "display": {
        "artUrl": "https://sandbox.api.visa.com/image.png",
        "backgroundColor": "1A1F71",
        "foregroundColor": "000000",
        "description": "Visa Test Bank",
        "issuerName": "Test Issuer"
      }
    },
    "credentialTypes": ["network-token", "virtual-card", "pan"],
    "createdAt": "2025-06-16T14:00:00Z"
  }
]
    }
  ]
}

Response Properties

Array of payment method objects:

Property	Type	Description
`id`	string	The payment method ID.
`type`	string	The payment method type.
`entityId`	string	The ID for the entity that owns the payment method.
`card`	Card Object	Specific details for `"card"` payment method `type`.
`credentialTypes`	string[]	Array of available credential types that can be created.
`createdAt`	datetime	The payment method created date.

Card Object

Property	Type	Description
`type`	string	The card type: `debit` or `credit`.
`brand`	string	The card brand (i.e. `visa`, `mastercard`).
`details`	Card Details Object	Details about the card.
`display`	Card Display Object	UI details for displaying the card.

Card Details Object

Property	Type	Description
`bin`	string	6 digit card BIN number.
`last4`	string	Card last 4 numbers.
`expirationMonth`	string	Card expiration month in `MM` format.
`expirationYear`	string	Card expiration year in `YYYY` format.

Card Display Object

Property	Type	Description
`artUrl`	string	A URL for the card art (if available).
`backgroundColor`	string	The background color for rendering the card UI.
`foregroundColor`	string	The foreground color for rendering the card UI.
`description`	string	Short card description.
`issuerName`	string	The card issuer’s name.