Provision and inspect customer identities without exposing numeric database identifiers.
A foreign or missing reference returns the same not-found response. Payer changes are audited and never rewrite existing invoices or transactions.
| Method | Path | Required scope | Description |
|---|---|---|---|
| GET | /customers | customers:read | List customers in this reseller tenant. |
| POST | /customers | customers:write | Create a customer with an optional initial password. |
| POST | /customers/invite | customers:write | Send account activation to an existing tenant customer. |
| GET | /customers/{customer_ref} | customers:read | Read one tenant-scoped customer. |
| GET/PATCH | /customers/{customer_ref}/profile | customers:read/write | Read audit history or update names and external reference. |
| GET/PUT | /customers/{customer_ref}/payer-profile | customers:read/write | Read or replace payer details used for future documents. |
curl --request POST 'https://phylex.net/api/proxy/reseller-api/v1/customers' \
--header 'Authorization: Bearer phxrk_REPLACE_WITH_YOUR_KEY' \
--header 'Content-Type: application/json' \
--data '{"email":"customer@example.com","password":"use-a-unique-secret","first_name":"Alex","last_name":"Doe","country_code":"de"}'