MVS Pay APICustomers

List a customer's saved payment methods

Lists the tokenized payment methods saved for a customer. The customer is resolved by org-scoped id; if it has no linked Hyperswitch customer identity an empty list is returned. Otherwise the methods are fetched from the payments engine. As a side effect the server reconciles an owned, masked-metadata record of each saved card (dual-vault Flow B) on a best-effort basis — this never affects the list response.

Authentication

x-api-keystring

A scoped MvsPayApiKey, e.g. mvspay_live_…. Mint and scope keys from the dashboard (Settings → API Keys).

Path parameters

idstringRequired

The org-scoped billing customer id.

Response

The customer’s saved payment methods (empty array if the customer has no linked identity or none saved).

paymentMethodslist of objects

Errors

401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error
502
Bad Gateway Error