Skip to main content
POST
Issue the customer's singleton PPV payment address.

Authorizations

Authorization
string
header
required

Integration-key Basic Auth (clientId:clientSecret) as documented in docs/public/AUTHENTICATION.md.

Path Parameters

customerId
string<uuid>
required

System-generated customer UUID for the existing customer that owns or will receive the issued PPV payment address.

Response

Customer payment address returned.

Frozen MVP public customer payment-address issuance response. ppvAddress is returned in plain localPart@ppvDomain form for public surfaces.

customerId
string<uuid>
required

System-generated customer UUID that owns this issued PPV address.

platformCustomerId
string
required

Platform-side customer identifier bound to the customer that owns this issued PPV address.

addressId
string
required

Stable identifier for the issued customer payment-address record.

ppvAddress
string
required

Public PPV address in plain localPart@ppvDomain format.

status
enum<string>
required

Current lifecycle status for the issued customer payment address.

Available options:
ACTIVE
isDefault
boolean
required

Whether this is the active default PPV address for the customer.

createdAt
string<date-time>
required

Address issuance timestamp.

updatedAt
string<date-time>
required

Last update timestamp for this customer payment-address record.