Read customer finance history, create idempotent orders, and discover the payment rails enabled for the reseller workspace.
Order price, reseller markup, tenant ownership, account state, and available balance are recalculated server-side.
| Method | Path | Required scope | Description |
|---|---|---|---|
| GET | /payment-methods | payments:read | List payment methods enabled for this reseller without credentials. |
| GET | /customers/{customer_ref}/balance | finance:read | Read the authoritative tenant wallet including holds. |
| GET | /customers/{customer_ref}/invoices | finance:read | Read the latest 200 tenant invoices. |
| GET | /customers/{customer_ref}/invoices/{invoice_ref} | finance:read | Read one invoice with immutable line items. |
| GET | /customers/{customer_ref}/transactions | finance:read | Read the latest 200 tenant transactions. |
| GET | /customers/{customer_ref}/transactions/{transaction_ref} | finance:read | Read one tenant transaction. |
| GET | /customers/{customer_ref}/orders | finance:read | Read the latest 200 tenant service orders. |
| GET | /customers/{customer_ref}/orders/{order_ref} | finance:read | Read one tenant service order. |
| POST | /customers/{customer_ref}/orders | orders:write | Buy an enabled reseller plan from the customer's authoritative balance. |
| POST | /customers/{customer_ref}/payment-links | payments:write | Create a single-use payment link bound to this exact customer. |
| GET/DELETE | /customers/{customer_ref}/payment-links/{payment_link_ref} | finance:read / payments:write | Inspect or revoke a customer payment link. |
curl --request POST 'https://phylex.net/api/proxy/reseller-api/v1/customers/PHX-RCU-0000002A/orders' \
--header 'Authorization: Bearer phxrk_REPLACE_WITH_YOUR_KEY' \
--header 'Idempotency-Key: order_018f_unique' \
--header 'Content-Type: application/json' \
--data '{"type":"kvm","plan_code":"RZX1","period":"monthly"}'curl --request POST 'https://phylex.net/api/proxy/reseller-api/v1/customers/PHX-RCU-0000002A/payment-links' \
--header 'Authorization: Bearer phxrk_REPLACE_WITH_YOUR_KEY' \
--header 'Idempotency-Key: payment_link_018f_unique' \
--header 'Content-Type: application/json' \
--data '{"amount":25,"currency":"EUR","payment_method":"stripe","expires_in_seconds":3600}'