Get a link request created by this service provider
Authorization
ApiKey ApiKeyId In: header
In: header
Path Parameters
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/partner_api/service_providers/business_link_requests/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "pending", "merchantBusinessId": "19d467bb-96e1-48c8-88c3-25dccb98467b", "merchantBusinessName": "string", "serviceProviderBusinessId": "d9fd5ed9-0f9b-4b0c-b030-b83b3b58501a", "serviceProviderBusinessName": "string", "ownerPhone": "string", "expiresAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z", "serviceProviderMemberId": "9521dd7f-48f7-49ed-bc06-95594b46066b"}Request to link an existing merchant business POST
Asks existing Jeko merchants (matched by owner phone) to authorize linking this service provider. Does not create a membership until the merchant approves. **Errors:** - 404 `user_not_found` — no Jeko user with this phone; use `/business_onboarding` - 409 `no_owned_business` — user exists but owns no business - 409 `already_linked` — already a service provider of that merchant (`extras` is the merchant business id)
Onboard a new business (Service Provider API) POST
Onboards a new merchant business on behalf of a service provider. This endpoint creates a new user, business, and establishes the service provider relationship. **Use Cases:** - Service providers (like Payme) can onboard merchants through their own platform - Automates the business registration process - Establishes the service provider relationship automatically **What This Endpoint Does:** 1. Creates a new user account (if phone number doesn't exist) 2. Creates a new business with the provided information 3. Sets up the business configuration (enables API access) 4. Creates a service provider business member linking the service provider to the merchant 5. Sets referral code if provided **Important Notes:** - The authenticated business must be a service provider (checked via middleware) - Phone number must **not** already be associated with any existing user in Jeko. If a user with this phone number already exists (regardless of their onboarding status), the request fails with an error. - The service provider business is automatically linked to the merchant business - API access is automatically enabled for the new merchant business **Authentication:** Requires API key headers. The authenticated business must be a service provider.