Update seller

Credentials

Replace a seller's details. Send all required fields on every request.

Parameters

Name In Type Required Description
sellerId path string yes Seller UUID (v4), as returned by Create seller or Get seller. An MPL is not accepted here.

Request body

Content type: application/json

Field Type Required Description
firstName string yes Seller's first name, 2 to 250 characters: letters, spaces and the marks - _ . , ' " ״ ( ) : ;.
lastName string yes Seller's last name, 2 to 250 characters: letters, spaces and the marks - _ . , ' " ״ ( ) : ;.
email string yes Primary email address
contactEmail string yes Business contact email
phone string yes Phone number, 1 to 250 characters.
businessName string yes Legal business name, at most 250 characters.
businessType integer yes Israeli business type. - 0 Not sure (לא ידוע) - 1 Osek Murshe, sole proprietorship (עוסק מורשה) - 2 Osek Patur, exempt small business (עוסק פטור) - 3 Incorporated company (חברה בע"מ) - 4 Partnership (שותפות) - 6 Non-profit (עמותה) - 7 Limited partnership (שותפות מוגבלת) - 8 Publicly traded company (חברה ציבורית) - 9 Shared cooperative (אגודה שיתופית) - 10 Public benefit company (חברה לתועלת הציבור)
businessNumber string yes Israeli business registration number (ח.פ. / עוסק מורשה). Digits only, at most 9, with a valid check digit.
socialId string yes Israeli ID number (תעודת זהות). Digits only, at most 9, with a valid check digit.
industryClassification number no Industry classification code
bankId string no Israeli bank code Digits only.
accountNumber string no Bank account number Digits only.
branchNumber string no Bank branch number Digits only.
logo string no Business logo as base64 encoded data URI

Request example

{
  "firstName": "David",
  "lastName": "Cohen",
  "email": "david.cohen1115@example.com",
  "contactEmail": "seller@example.com",
  "phone": "0500000008",
  "businessName": "Cohen Electronics",
  "businessType": 2,
  "businessNumber": "330988015",
  "socialId": "123456782",
  "bankId": "12",
  "accountNumber": "123456789012345",
  "branchNumber": "123",
  "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}

Code samples

curl

curl -X PUT 'https://<partner_domain>.keep.co.il/api/public/sellers/<sellerId>/update' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  --data-raw '{
  "firstName": "David",
  "lastName": "Cohen",
  "email": "david.cohen1115@example.com",
  "contactEmail": "seller@example.com",
  "phone": "0500000008",
  "businessName": "Cohen Electronics",
  "businessType": 2,
  "businessNumber": "330988015",
  "socialId": "123456782",
  "bankId": "12",
  "accountNumber": "123456789012345",
  "branchNumber": "123",
  "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}'

Node.js

const response = await fetch("https://<partner_domain>.keep.co.il/api/public/sellers/<sellerId>/update", {
  method: "PUT",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <YOUR_TOKEN>",
  },
  body: JSON.stringify({
    "firstName": "David",
    "lastName": "Cohen",
    "email": "david.cohen1115@example.com",
    "contactEmail": "seller@example.com",
    "phone": "0500000008",
    "businessName": "Cohen Electronics",
    "businessType": 2,
    "businessNumber": "330988015",
    "socialId": "123456782",
    "bankId": "12",
    "accountNumber": "123456789012345",
    "branchNumber": "123",
    "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  }),
});

console.log(await response.text());

Python

import requests

response = requests.put(
    "https://<partner_domain>.keep.co.il/api/public/sellers/<sellerId>/update",
    headers={
        "Authorization": "Bearer <YOUR_TOKEN>",
    },
    json={
        "firstName": "David",
        "lastName": "Cohen",
        "email": "david.cohen1115@example.com",
        "contactEmail": "seller@example.com",
        "phone": "0500000008",
        "businessName": "Cohen Electronics",
        "businessType": 2,
        "businessNumber": "330988015",
        "socialId": "123456782",
        "bankId": "12",
        "accountNumber": "123456789012345",
        "branchNumber": "123",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    },
)

print(response.text)

PHP

<?php

$body = <<<'BODY'
{
  "firstName": "David",
  "lastName": "Cohen",
  "email": "david.cohen1115@example.com",
  "contactEmail": "seller@example.com",
  "phone": "0500000008",
  "businessName": "Cohen Electronics",
  "businessType": 2,
  "businessNumber": "330988015",
  "socialId": "123456782",
  "bankId": "12",
  "accountNumber": "123456789012345",
  "branchNumber": "123",
  "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}
BODY;

$ch = curl_init('https://<partner_domain>.keep.co.il/api/public/sellers/<sellerId>/update');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer <YOUR_TOKEN>',
    ],
    CURLOPT_POSTFIELDS => $body,
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Responses

200 — Seller updated successfully (success)

{}

400 — Bad Request. Returned for validation errors, when sellerId is not a UUID v4, and with the message Bad identifier when the seller does not exist. (error)

Field Type Description
statusCode integer HTTP status code
message string Error message(s)
error string Error type 
{
  "statusCode": 400,
  "message": [
    "Validation failed"
  ],
  "error": "Bad Request"
}

401 — Unauthorized (error)

Field Type Description
statusCode integer
message string 
{
  "statusCode": 401,
  "message": "Unauthorized"
}

403 — The seller does not belong to your partner account (error)