MVS Pay APICustomers

Create a customer

Creates a billing customer for the authenticated organization via the MVS Pay client (which also provisions the underlying Hyperswitch customer identity). Pass an Idempotency-Key header to make retries safe. The response is the created customer object as returned by the MVS Pay client (loosely typed; extra fields pass through).

Authentication

x-api-keystring

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

Headers

Idempotency-KeystringOptional

Client-supplied idempotency key for safe retries.

Request

This endpoint expects an object.
emailstringOptionalformat: "email"
Customer email.
namestringOptional
Customer full name.
phonestringOptional
Customer phone number.

Response

The created customer.
idstring

The org-scoped billing customer id.

emailstring or null
namestring or null
phonestring or null

Errors

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