Skip to main content
POST
/
customers
/
{customerId}
/
payment-address
Issue the customer's singleton PPV payment address.
curl --request POST \
  --url https://{publicHost}/customers/{customerId}/payment-address \
  --header 'Authorization: Basic <encoded-value>'
{
  "customerId": "019542f5-b3e7-1d02-0000-000000000001",
  "platformCustomerId": "partner_cust_001",
  "addressId": "addr_123",
  "ppvAddress": "demo-customer@demo.blips.test",
  "status": "ACTIVE",
  "isDefault": true,
  "createdAt": "2026-04-05T12:00:00Z",
  "updatedAt": "2026-04-05T12:00:00Z"
}

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 user@domain 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

Issued PPV address in plain user@domain form.

​
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.