Jèko
Service Providers

Get a link request created by this service provider

GET
/partner_api/service_providers/business_link_requests/{linkRequestId}

Authorization

ApiKey ApiKeyId
X-API-KEY<token>

In: header

X-API-KEY-ID<token>

In: header

Path Parameters

linkRequestId*string
Formatuuid

Response 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.