Skip to main content
POST
/
customers
/
{customerId}
/
payment-address
Issue the customer's singleton PPV payment address.
curl --request POST \
  --url https://public-test.blips.network/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@pay.example.blips", "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 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.