Open an End Customer
customer:end_customers:manageAPI referansındaki uç nokta açıklamaları İngilizcedir.Opens an End Customer of the Platform in profile_pending. The Platform then passes its onboarding for it through the Onboarding operations with Apex-End-Customer set to its id; once it is approved it is submitted to the Providers that approved the Platform. Alternatively invite_email invites its first person to do that in the Customer panel; only a person of the Platform can invite, so an API key sending invite_email is refused with people_only. country must be one the platform serves.
Requires the customer:end_customers:manage permission. Send an Idempotency-Key: a retry with the same key and body answers the first response again (marked Idempotency-Replayed: true) for 24 hours.
ApiKeyYetkilendirmeBearer <API key>A Customer API key, created by a Customer admin in the Customer panel and shown once: Authorization: Bearer ak_live_… in production, ak_test_… elsewhere. A key holds a subset of its creator's permissions and may be limited to named IP addresses and an expiry date. Keys never manage people, other keys or approval rules, and never approve a Payout.
Idempotency-Key*stringA unique key per intended request, such as a UUID. A retry with the same key and body answers the first response again for 24 hours instead of acting twice; the same key with another body is idempotency_key_reused. An error answer is not kept, so a request that failed may be retried under its key.
length <= 128The End Customer.
application/json- body
country*stringemail*stringlength <= 254invite_email?stringinvite_email invites the End Customer's first person; only a person of the Platform may send it.
length <= 254invite_name?stringlength <= 120legal_name*stringlength <= 256type*CustomerType"individual""business"Created
application/json- response
country*stringcreated_at*stringdate-timeemail*stringhas_people?booleanhas_people is answered on one End Customer, not on a list row.
id*stringlegal_name*stringproviders*array<>standing*string"onboarding""active""suspended""closed"state*string"profile_pending""profile_review""provider_onboarding""active""suspended""rejected"suspended_by?stringsuspended_by is who suspended it: platform (the Platform may reactivate it) or operator (only the operations team can).
"operator""platform"suspended_reason?stringsuspended_reason is the Platform's own reason, shown when the Platform suspended it.
type*string"individual""business"updated_at*stringdate-timecurl -X POST 'http://localhost:3480/v1/end-customers' \ -H 'Idempotency-Key: 5f1c2b9e-6a1d-4c3e-9b7a-2d8e4f6a1c03' \ -H 'Content-Type: application/json' \ -d '{ "country": "PK", "email": "lina@example.com", "legal_name": "Lina Qureshi", "type": "individual"}'{ "country": "PK", "created_at": "2026-11-10T14:05:00Z", "email": "lina@example.com", "has_people": false, "id": "3f6c2a9e-8b1d-4c7a-9e2f-5a6b7c8d9e0f", "legal_name": "Lina Qureshi", "providers": [ { "provider": "bvnk", "state": "approved" } ], "standing": "active", "state": "active", "suspended_by": "operator", "suspended_reason": "string", "type": "individual", "updated_at": "2026-11-11T10:20:00Z"}