Update a seller

• Sandbox: POST https://sandbox.payme.io/api/update-seller
• Production: POST https://live.payme.io/api/update-seller

Credentials

• Request body field payme_client_key (required): Your partner key.
• Request body field seller_payme_id (optional): The seller's MPL. Required unless you send seller_id.

Changes the details of one of your sellers. Partners only: send your payme_client_key, the seller's seller_payme_id (or your own seller_id for the seller), and only the fields you want to change. Every other field is optional.

PayMe sets, per partner, which fields can still be changed once they have a value. Changing a locked field that already has a value returns error 33. A request with no updatable field returns error 19. The response returns the seller's details after the update.

The seller's default market_fee can't be changed with this call. To change it, contact PayMe Partners (partners@payme.io). The per-sale market_fee on generate-sale is not affected.

seller_additional_details adds people to the seller. It doesn't change or remove the people already on file.

In the sandbox, the test values listed on Create a seller work here too.

Callback

After the update, PayMe sends a seller callback (POST, x-www-form-urlencoded) to your default callback URL. The fields are listed on Callbacks → Sellers.

Errors

Every error returns status_code 1 with the code in status_error_code. Besides the field validation errors listed on Create a seller:

The full list is on Errors.

Parameters

This endpoint takes no path, query or header parameters.

Request body

Content type: application/json

Request example

{
  "payme_client_key": "XXXXXXXX",
  "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567",
  "seller_site_url": "https://www.example.com",
  "seller_contact_phone": "+972501234567",
  "language": "en"
}

Code samples

curl

curl -X POST 'https://sandbox.payme.io/api/update-seller' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "payme_client_key": "XXXXXXXX",
  "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567",
  "seller_site_url": "https://www.example.com",
  "seller_contact_phone": "+972501234567",
  "language": "en"
}'

Node.js

const response = await fetch("https://sandbox.payme.io/api/update-seller", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "payme_client_key": "XXXXXXXX",
    "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567",
    "seller_site_url": "https://www.example.com",
    "seller_contact_phone": "+972501234567",
    "language": "en"
  }),
});

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

Python

import requests

response = requests.post(
    "https://sandbox.payme.io/api/update-seller",
    json={
        "payme_client_key": "XXXXXXXX",
        "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567",
        "seller_site_url": "https://www.example.com",
        "seller_contact_phone": "+972501234567",
        "language": "en",
    },
)

print(response.text)

PHP

<?php

$body = <<<'BODY'
{
  "payme_client_key": "XXXXXXXX",
  "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567",
  "seller_site_url": "https://www.example.com",
  "seller_contact_phone": "+972501234567",
  "language": "en"
}
BODY;

$ch = curl_init('https://sandbox.payme.io/api/update-seller');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $body,
]);

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

echo $response;

Responses

200 — OK (success)

{
  "status_code": 0,
  "session": "a1B2c3D4",
  "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567",
  "seller_id": "store-1001",
  "seller_created": "2026-01-15 10:30:00",
  "seller_active": true,
  "seller_approved": true,
  "seller_withdrawal_plan": 1,
  "seller_withdrawal_date": null,
  "seller_personal_details": {
    "seller_first_name": "Dana",
    "seller_last_name": "Levi",
    "seller_gender": 1,
    "seller_email": "dana@example.com"
  },
  "seller_business_details": {
    "seller_inc": 0,
    "seller_merchant_name": "Dana Ceramics",
    "seller_site_url": "https://www.example.com",
    "seller_contact_phone": "+972501234567"
  },
  "seller_address": {
    "seller_address_city": "Tel Aviv",
    "seller_address_country": "IL"
  },
  "seller_display_language": "he"
}

500 — Error, for example error 33: a locked field already has a value (error)

{
  "status_code": 1,
  "status_error_details": "Cannot update as field is already set",
  "status_additional_info": "seller_bank_account_number",
  "status_error_code": 33,
  "session": "a1B2c3D4"
}