POST /v1/customers:ensure
Identity-only bootstrap: validates the signed subject; grants no merchant or product permissions.
The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.
Parameters
No path or query parameters.
Request body
customer_account_idstringenvironment_idstringpurposestringtenant_idstring
cURL
curl --request POST 'https://pay.bytecome.com/v1/customers:ensure' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"tenant_id": "<tenant-id>",
"environment_id": "<environment-id>",
"purpose": "PURCHASE"
}'Response contract
200 · OK
createdbooleancustomer_account_idstringenvironment_idstringrolestring
Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.