# Marketplaces & Platforms ## Start Here - [Start here: build a platform or marketplace on PayMe](https://docs.payme.io/marketplaces-and-platforms/start-here/how-platforms-work): Map of the PayMe partner model. A partner holds payme_client_key and a client password; each seller has its own MPL (seller_payme_id), public key, balance and bank account. Steps: onboard sellers (create-seller, documents, approval), enable payment methods (vas-enable), create sales with the seller's MPL and market_fee, handle callbacks, pay out (withdrawals), report. PayMe sets partner-level defaults: callback and return URLs, required seller fields, withdrawal plan, price range, rate limit. Seller callbacks go to the partner's default callback URL. ## Prerequisites - Partner credentials (payme_client_key and client password) from PayMe Partners ## Related - [Onboard a seller, from creation to first payout](https://docs.payme.io/marketplaces-and-platforms/seller-onboarding/onboard-a-seller) - [Create sellers](https://docs.payme.io/marketplaces-and-platforms/seller-onboarding/create-seller) - [Platform fees](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/platform-fees) - [Withdrawals](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/withdrawals) - [Reporting across your sellers](https://docs.payme.io/marketplaces-and-platforms/reporting/reporting-across-your-sellers) - [Authentication](https://docs.payme.io/payments/getting-started/authentication) - [Callbacks](https://docs.payme.io/payments/getting-started/callbacks) - [Get API access and go live: from sandbox to production](https://docs.payme.io/payments/getting-started/go-live) # Start here: build a platform or marketplace on PayMe As a platform or marketplace, you are a PayMe **partner**. You onboard your sellers under your partner account, take payments for them, can collect a platform fee on each sale, and PayMe pays each seller out to its own bank account. This page maps the whole flow and links to the guide for each step. ## How the model works ```text Partner (you): payme_client_key + client password ├─ Seller A: seller_payme_id (MPL), public key, balance, bank account ├─ Seller B: seller_payme_id (MPL), public key, balance, bank account └─ … Buyer pays a sale of Seller A └─ PayMe ─┬─ Seller A's balance (after PayMe's fees and your market_fee) ─▶ withdrawal to A's bank account └─ your platform fee (market_fee) ─▶ transferred to you ``` | Term | What it is | |---|---| | Partner | You. You hold `payme_client_key` and its client password, issued by PayMe Partners (). PayMe also keeps settings for your whole partner account. | | Seller | Each business on your platform. It has its own `seller_payme_id` (MPL), public key, balance and bank account. | | Sale | Always belongs to one seller. The buyer pays the seller. | | Platform fee | `market_fee`: a percent of each sale that PayMe collects for you from the seller, on top of PayMe's own fees. By default it is transferred to you once a month. | | Withdrawal | Moves a seller's released balance to its bank account, once PayMe has approved the seller. | ## Your credentials and your sellers' | You want to | Send | Notes | |---|---|---| | Create a seller | `payme_client_key` | Partner-only: [create-seller](https://docs.payme.io/payments/merchants-management/post-create-seller) returns the seller's MPL | | Update a seller or upload its documents | `payme_client_key` and the seller's `seller_payme_id`, or your `seller_id` for it | Partner-only: [update-seller](https://docs.payme.io/payments/merchants-management/post-update-seller), [upload-seller-files](https://docs.payme.io/payments/merchants-management/post-upload-seller-files) | | Read or enable a seller's services | `payme_client_key` and the seller's `seller_payme_id` | Partner-only: [get-vas-seller](https://docs.payme.io/payments/merchants-management/post-get-vas-seller), `vas-enable` | | Request a seller's withdrawal | `payme_client_key` and the seller's `seller_payme_id` | [withdraw-balance](https://docs.payme.io/payments/merchants-management/post-withdraw-balance) | | Create a sale for a seller | The seller's `seller_payme_id` in the JSON body. You can add `payme_client_key`. | Or send your `seller_id` for the seller together with `payme_client_key`. See [generate-sale](https://docs.payme.io/payments/hosted-payment-page/post-generate-sale). | | Refund a seller's sale | The seller's `seller_payme_id`. You can add `payme_client_key`. | See [refund-sale](https://docs.payme.io/payments/post-sale-actions/post-refund-sale). | | Report across your sellers | `payme_client_key` alone covers all your sellers. Add `seller_payme_id`, one MPL or an array of up to 100, to narrow it. | `get-sales`, `get-transactions`, `get-sellers`, `get-subscriptions`, `get-withdrawals`. See [Reporting across your sellers](https://docs.payme.io/marketplaces-and-platforms/reporting/reporting-across-your-sellers). | | Run Hosted Fields, Apple Pay or Google Pay in the browser | The seller's public key | From `seller_public_key` on create-seller or the `seller-create` callback, or from [List a seller's public keys](https://docs.payme.io/payments/merchants-management/get-sellers-mpl-public-keys). | The rules: - When you send `payme_client_key` with a `seller_payme_id`, the seller must be one of yours. Otherwise the call fails with error `20`. - `seller_id` is your own ID for a seller, set on create-seller. It must be unique among your sellers (error `108`), and it identifies the seller only together with `payme_client_key`. - Keep `payme_client_key`, the client password and every MPL on your server. Only the public key goes into browser or mobile code. - Ignore `seller_payme_secret` on create-seller: it isn't a credential. - Verify `payme_signature` on sale callbacks with your `payme_client_key` and client password. Seller and withdrawal callbacks carry no signature: re-read them with `get-sellers` or `get-withdrawals`. See [Callbacks](https://docs.payme.io/payments/getting-started/callbacks). - Saved cards: a token captured without `"buyer_is_private": true` belongs to your partner account, and any of your sellers can charge it. Reading it with [get-buyer-key](https://docs.payme.io/payments/tokenization/post-get-buyer-key) and a seller's MPL returns error `603`: send `payme_client_key` instead. Capture with `"buyer_is_private": true` to keep a token with one seller. More on each credential: [Authentication](https://docs.payme.io/payments/getting-started/authentication). ## The integration, step by step 1. **Onboard your sellers.** Create each seller, upload its documents and wait for PayMe's approval. See [Onboard a seller, from creation to first payout](https://docs.payme.io/marketplaces-and-platforms/seller-onboarding/onboard-a-seller) and [Create sellers](https://docs.payme.io/marketplaces-and-platforms/seller-onboarding/create-seller). 2. **Turn on payment methods.** A seller installs Apple Pay, Google Pay or Bit from the dashboard app store (חנות אפליקציות), or you enable it with `vas-enable`: see [Accept Apple Pay](https://docs.payme.io/accepting-payments/payment-methods/apple-pay) and [Accept Google Pay](https://docs.payme.io/accepting-payments/payment-methods/google-pay). Check what a seller has with [get-vas-seller](https://docs.payme.io/payments/merchants-management/post-get-vas-seller). 3D Secure is enabled on the account by PayMe. 3. **Take payments, with your fee.** Create each sale with the seller's MPL, and send `market_fee` to override the seller's default fee. See [Platform fees](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/platform-fees). 4. **Handle callbacks.** Sale callbacks go to the sale's `sale_callback_url`. Seller and withdrawal callbacks go to your partner account's default callback URL. See [Callbacks](https://docs.payme.io/payments/getting-started/callbacks). 5. **Pay your sellers out.** See [Withdrawals](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/withdrawals). 6. **Report and reconcile.** See [Reporting across your sellers](https://docs.payme.io/marketplaces-and-platforms/reporting/reporting-across-your-sellers) and [Reconcile sales and withdrawals](https://docs.payme.io/accepting-payments/reporting/reconcile-sales-and-withdrawals). A sale for one of your sellers, with a 2.5% platform fee: ```bash curl -X POST https://sandbox.payme.io/api/generate-sale \ -H 'Content-Type: application/json' \ -d '{ "payme_client_key": "XXXXXXXX", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_price": 10000, "currency": "ILS", "product_name": "Test order", "transaction_id": "order-1001", "sale_callback_url": "https://your-server.example.com/payme/callback", "sale_return_url": "https://your-site.example.com/payment/success", "market_fee": 2.5, "language": "en" }' ``` On this sale of `10000` (100.00), your fee is `250` (2.50). ## Settings PayMe keeps for your partner account These settings apply to every seller under your partner account. PayMe sets them; to set or change one, contact PayMe Partners (). | Setting | What it does | |---|---| | Default sale callback URL | Receives the callbacks of a sale created without `sale_callback_url`. If your account has no dedicated sale callback URL, the default callback URL is used. | | Default callback URL | Receives the seller callbacks (`seller-create`, `seller-update`, `seller-approve`) and `withdrawal-complete`, and the callbacks of a subscription created without `sub_callback_url`. Without it, PayMe sends no seller callbacks. | | Default return URL | Where the buyer goes after paying a sale created without `sale_return_url`. | | Required seller fields | Which create-seller fields are required for your sellers. A missing one returns error `19`. | | Withdrawal plan | The plan each new seller starts on: manual or automatic. No API field changes it. | | Sale price range | The default `sale_price` range is `500`–`4000000` minor units. A different range set for you applies to all your sellers. | | Rate limit | Payment calls share a per-seller limit. A limit set for you applies to each of your sellers separately. See [Rate limits](https://docs.payme.io/payments/getting-started/idempotency-and-retries#rate-limits). | A default URL is shared by all your sellers. To route one seller's callbacks elsewhere, send `sale_callback_url` on each of its sales: a seller has no dashboard setting for it. ## Know these before you build - **Payments start before approval; payouts don't.** A new seller can take payments at once. Withdrawals wait until PayMe approves the seller (error `109`). - **A seller's default fee is set once.** `market_fee` on create-seller sets the seller's default. Update-seller can't change it: contact PayMe Partners, and send `market_fee` on each sale until it changes. - **Sellers paid directly** by the card companies ignore the `market_fee` sent on a sale (the seller's default applies), and can't request withdrawals (error `908`). - **Create-seller is rate limited** to 5 calls per minute per IP (error `998`). ## Test as a partner in the sandbox - Create test sellers with the values on [Creating test sellers](https://docs.payme.io/payments/getting-started/test-cards-and-payment-methods#creating-test-sellers-partners). - Sellers created on the sandbox test account start on an automatic withdrawal plan, so ask PayMe to set up a test seller before you test a withdrawal. - Pay with the [test cards](https://docs.payme.io/payments/getting-started/test-cards-and-payment-methods). When you are ready for production, follow [Get API access and go live](https://docs.payme.io/payments/getting-started/go-live). ## Seller Onboarding - [Create sellers](https://docs.payme.io/marketplaces-and-platforms/seller-onboarding/create-seller): Partner guide to onboarding sellers. Create a seller with POST /create-seller (payme_client_key required; PayMe sets the required fields per partner, error 19; 5 calls per minute per IP, error 998) and store the returned seller_payme_id (MPL), or send the seller the seller_dashboard_signup_link to finish on PayMe's onboarding pages. Upload documents with upload-seller-files. Sellers can take payments at once; payouts wait for PayMe's approval. # Create sellers As a partner, you create each seller once and get back its `seller_payme_id` (MPL). Store it: you send it on every call for that seller. Only partners can create sellers, with their `payme_client_key`. There are two ways to onboard a seller: 1. **API:** collect the seller's details on your platform and call [Create a seller](https://docs.payme.io/payments/merchants-management/post-create-seller). Then upload the seller's documents with [Upload seller files](https://docs.payme.io/payments/merchants-management/post-upload-seller-files). 2. **PayMe's onboarding pages:** send the seller the `seller_dashboard_signup_link` that Create a seller returns. The seller fills in the rest of the details and uploads documents there. The pages can carry your logo and colors: [contact PayMe](https://payme.io/contact-us/) to set this up. ## Before you start - PayMe sets which fields are required for your account. A missing required field returns error `19`, with the field name in `status_additional_info`. - Create a seller is limited to 5 calls per minute per IP. Over the limit, you get HTTP 429 with error `998`. - `seller_email` must be unique among your sellers (error `150`). - In the sandbox, use the test values listed on [Create a seller](https://docs.payme.io/payments/merchants-management/post-create-seller), such as bank `54`. ## After you create a seller - The seller can take payments right away. Payouts wait until PayMe approves the seller (`seller_approved` on [List sellers](https://docs.payme.io/payments/query-apis/post-get-sellers)). See [Withdrawals](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/withdrawals). - Approval needs the seller's documents. The codes are on [File types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/file-types). - PayMe sends a seller [callback](https://docs.payme.io/payments/getting-started/callbacks) to your default callback URL when the seller is created, updated or approved. ## What the onboarding pages ask for This is an example of PayMe's onboarding page. The steps can be split over several screens. ![PayMe onboarding page example](https://docs.payme.io/marketplaces-and-platforms/_files/uxxGEFMKMJg.jpg) ### Personal details | Field | Description | | --- | --- | | **First name** | The contact person's first name | | **Last name** | The contact person's last name | | **ID number** | The contact person's national ID number | | **Email address** | The seller's email address. It must be unique among your sellers | | **Phone number** | The business phone number | | **Contact phone** | The contact person's phone number | | **Contact email** | The contact person's email address | | **Password** | The seller's password for the PayMe dashboard | ### Company details | Field | Description | | --- | --- | | **Company name** | The business's legal name | | **Registration number** | The business's registration number | | **Company type** | One of the [seller incorporation types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/seller-incorporation-types-il) | | **Acquirer registration** | The seller's existing business code on the acquirer's network, if it has one | ### Bank account details | Field | Description | | --- | --- | | **Bank code** | A code from [Banks in Israel](https://docs.payme.io/payments/codes-statuses/banks-in-israel) | | **Bank branch** | Branch number | | **Bank account number** | Account number | - [Enable payment methods and services for your sellers](https://docs.payme.io/marketplaces-and-platforms/seller-onboarding/enable-services): Partner guide to seller services (VAS). Sellers install Apple Pay, Google Pay and Bit from the dashboard app store. Partners call vas-enable with payme_client_key, seller_payme_id and the partner's vas_payme_id (from PayMe Partners); status_code 0 = on, 2 = Zendesk ticket, PayMe completes it. Apple Pay needs vas_data.websites (up to 99, domain file checked live, 703). Check with get-vas-seller (vas_type names, error 24; no callback). Turn off with vas-disable; then sales with that method fail 720. 703 = partner lacks the service. ## Prerequisites - Partner credentials (payme_client_key) from PayMe Partners - The seller's seller_payme_id (MPL) - The vas_payme_id of each service on your partner account ## Related - [List a seller's services](https://docs.payme.io/payments/merchants-management/post-get-vas-seller) - [Enable Apple Pay for a seller](https://docs.payme.io/payments/apple-pay/post-vas-enable-apple-pay) - [Enable Google Pay for a seller](https://docs.payme.io/payments/google-pay/post-vas-enable-google-pay) - [Order POS devices](https://docs.payme.io/payments/point-of-sale-pos/post-vas-enable) - [VAS types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/vas-types) - [Accept Apple Pay](https://docs.payme.io/accepting-payments/payment-methods/apple-pay) - [Accept Google Pay](https://docs.payme.io/accepting-payments/payment-methods/google-pay) - [Accept Bit payments](https://docs.payme.io/accepting-payments/payment-methods/bit) - [Let the buyer choose how to pay](https://docs.payme.io/accepting-payments/checkout-and-in-person/let-the-buyer-choose) - [Create sellers](https://docs.payme.io/marketplaces-and-platforms/seller-onboarding/create-seller) # Enable payment methods and services for your sellers Payment methods other than cards, such as Apple Pay, Google Pay and Bit, and other value-added services (VAS) are turned on per seller. A seller can install them in the PayMe dashboard. As a partner, you turn them on, check them and turn them off with three API calls: | To | Call | |---|---| | Turn a service on | `POST /vas-enable` | | See what a seller has | [`POST /get-vas-seller`](https://docs.payme.io/payments/merchants-management/post-get-vas-seller) | | Turn a service off | `POST /vas-disable` | All three are partner-only. Send your `payme_client_key` and the seller's `seller_payme_id` in the JSON body; the seller must be one of yours. Base URL: `https://sandbox.payme.io/api` in the sandbox, `https://live.payme.io/api` in production. ## The seller's own path: the dashboard app store A seller who logs in to the PayMe dashboard installs Apple Pay, Google Pay or Bit from the app store (חנות אפליקציות). The method is active as soon as it is installed, and you don't need to do anything. A seller can't call `vas-enable` itself, because the call needs a partner key. A seller without a partner who wants to show Apple Pay on its own domains asks PayMe Partners () to register them. ## Before you start You need: - your partner key (`payme_client_key`); - the seller's MPL (`seller_payme_id`); - the `vas_payme_id` of each service: your partner account's ID for that service (`VASL…`). Ask PayMe Partners () for the IDs of the services on your account. You can turn on only the services that your partner account has. Any other returns error `703` with `Partner has no permission for this VAS`. ## Turn a service on `POST https://sandbox.payme.io/api/vas-enable` (production: `https://live.payme.io/api/vas-enable`) ```json { "payme_client_key": "payme_partner_key", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "vas_payme_id": "VASLDEMO-GOOGLEPAY-VASLDEMO-1234567", "language": "en" } ``` | Field | Required | Description | |---|---|---| | `payme_client_key` | Yes | Your partner key. Keep it on your server. | | `seller_payme_id` | Yes | The seller's MPL. The seller must be one of yours. | | `vas_payme_id` | Yes | Your partner account's ID for the service. | | `vas_data` | Depends on the service | The service's settings. See [What each service needs](#what-each-service-needs). | | `vas_payer_type` | No | Who pays the service fees: `1` – partner, `2` – seller, `3` – reseller. Used only when the service is first created for the seller. Default: the payer set on your partner account's service. | | `language` | No | Language of error messages: `he` (default) or `en`. | The response has one of two outcomes. **`status_code: 0` – the service is on.** The response holds the seller's own copy of the service: `vas_guid`, `vas_is_active: true`, its type, prices and settings. ```json { "status_code": 0, "session": "a1B2c3D4", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "vas_payme_id": "VASLDEMO-GOOGLEPAY-VASLDEMO-1234567", "vas_guid": "VASLDEMO-VASLDEMO-VASLDEMO-7654321", "vas_type": "AlternativePaymentMethod", "vas_name": null, "vas_is_active": true, "vas_payer_type": 2, "vas_price_currency": "ILS", "vas_price_setup_fixed": 0, "vas_price_periodic_fixed": 0, "vas_price_periodic_variable": "0.00", "vas_price_usage_fixed": 0, "vas_price_usage_variable": "0.00", "vas_market_fee": null, "vas_period": 1 } ``` **`status_code: 2` – PayMe's team completes the setup.** Some services are set up by hand. The call then opens a ticket for PayMe's team and answers: ```json { "status_code": 2, "session": "a1B2c3D4", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "message": "Zendesk ticket created" } ``` Check the result later with `get-vas-seller`: `vas_is_active` is `true` once the service is on. PayMe sends partners no callback when a seller's service changes. Calling `vas-enable` for a service the seller already has turns it back on and updates its settings with the `vas_data` you send. ## What each service needs | Service | `vas_data` | Notes | |---|---|---| | Apple Pay | `websites`: the domains that show the Apple Pay button on your own pages, up to 99 per call | PayMe checks every domain during the call. See [Apple Pay domains](#apple-pay-domains). PayMe's own payment-page host is registered for you. | | Google Pay | None | To show Google Pay on your own pages, also register your domain in the Google Pay & Wallet Console. See [Accept Google Pay](https://docs.payme.io/accepting-payments/payment-methods/google-pay). | | Bit | None | ILS only, one payment. See [Accept Bit payments](https://docs.payme.io/accepting-payments/payment-methods/bit). | | POS devices | The device order: `number_of_devices` and `items` | Two `vas-enable` calls, then a manual process. See [Order POS devices](https://docs.payme.io/payments/point-of-sale-pos/post-vas-enable). | | 3D Secure, invoicing, B2B transfers and other services | — | Set up by PayMe. Ask PayMe Partners (), with the seller's MPL. | Once a payment method is on, create sales with its `sale_payment_method` (`apple-pay`, `google-pay` or `bit`), or with `multi` to let the buyer choose: see [Let the buyer choose how to pay](https://docs.payme.io/accepting-payments/checkout-and-in-person/let-the-buyer-choose). A sale with a method the seller doesn't have fails with error `720`. ## Apple Pay domains To show the Apple Pay button on your own pages, register every domain and subdomain that shows it: 1. Serve PayMe's domain file, unchanged, at `https:///.well-known/apple-developer-merchantid-domain-association`. The sandbox and production files are different: see [Host PayMe's domain file](https://docs.payme.io/accepting-payments/payment-methods/apple-pay#step-1-host-paymes-domain-file). 2. Call `vas-enable` with the domains in `vas_data.websites`. PayMe fetches each domain's file, compares it with its own, and registers the domains with Apple in the same call. ```json { "payme_client_key": "payme_partner_key", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "vas_payme_id": "VASLDEMO-VASLDEMO-VASLDEMO-1234567", "vas_data": { "websites": ["example.com", "shop.example.com"] } } ``` - If any domain fails, the whole call fails with error `703`, and `status_additional_info` names each site: `: Certificate does not match, please reconfigure.` or `: Cannot locate certificate.` More than 99 domains also returns `703`. Fix the file and send the call again: nothing is left pending. - If Apple refuses the registration, the call returns error `20` with `Domain is not registered`. - To add domains later, call `vas-enable` again with the new ones. Domains already approved stay approved. - `vas-update`: contact PayMe support for adding Apple Pay domains to an enabled service. The whole Apple Pay setup, including the browser SDK, is on [Accept Apple Pay](https://docs.payme.io/accepting-payments/payment-methods/apple-pay). ## See what a seller has Call [`get-vas-seller`](https://docs.payme.io/payments/merchants-management/post-get-vas-seller). To list only payment methods, filter by `vas_type: AlternativePaymentMethod`. `POST https://sandbox.payme.io/api/get-vas-seller` (production: `https://live.payme.io/api/get-vas-seller`) ```json { "payme_client_key": "payme_partner_key", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "vas_type": "AlternativePaymentMethod", "language": "en" } ``` Each item in `items` is one of the seller's services. Read `vas_description` (the service's name), `vas_guid` (the seller's copy of the service) and `vas_is_active`. Send `vas_type` as a name from [VAS types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/vas-types): a number or an unknown name returns error `24`. Inactive sellers can be queried too. ## Turn a service off `POST https://sandbox.payme.io/api/vas-disable` (production: `https://live.payme.io/api/vas-disable`), with the same three IDs as `vas-enable`: ```json { "payme_client_key": "payme_partner_key", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "vas_payme_id": "VASLDEMO-GOOGLEPAY-VASLDEMO-1234567" } ``` ```json { "status_code": 0, "session": "a1B2c3D4", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "vas_payme_id": "VASLDEMO-GOOGLEPAY-VASLDEMO-1234567" } ``` As with `vas-enable`, the answer can be `status_code: 2` with `Zendesk ticket created` when PayMe's team handles the change. If the seller doesn't have the service, the call returns error `720`. Once a payment method is off, a sale with that `sale_payment_method` fails with error `720`, and `multi` pages stop showing it. To turn it back on, call `vas-enable` again. ## Errors Errors return `status_code: 1` with `status_error_code`. | HTTP | `status_error_code` | When | |---|---|---| | 500 | `1` | `payme_client_key`, `seller_payme_id` or `vas_payme_id` is missing (`get-vas-seller` needs only the first two). | | 400 | `20` | The seller isn't one of yours, or Apple refused an Apple Pay domain registration. | | 500 | `24` | `get-vas-seller`: `vas_type` is a number or an unknown name. | | 500 | `200` | The partner key is unknown. | | 500 | `251` | The seller key is unknown. | | 400 or 500 | `703` | Your partner account doesn't have this service, partners can't change it, or an Apple Pay domain check failed. | | 400 or 500 | `720` | No active service has this `vas_payme_id` (HTTP 500), or, on `vas-disable`, the seller doesn't have the service (HTTP 400). | All error codes are on [Errors](https://docs.payme.io/payments/getting-started/errors). - [Onboard a seller, from creation to first payout](https://docs.payme.io/marketplaces-and-platforms/seller-onboarding/onboard-a-seller): Partner guide to a seller's lifecycle. Collect details (PayMe sets required fields per partner, error 19). create-seller: store the MPL and public key, send seller_dashboard_signup_link; 5 calls/min per IP. Documents: 1 and 2 for every seller, 3 for most; 90-97 are personal (error 184). Approval: seller-approve callback and seller_approved on get-sellers; seller-update arrives during review. Then services, the first sale, and the first payout: approved, bank details, released funds, minimum 100.00; plans 1/2/3; errors 109, 907, 908, 913. ## Prerequisites - Partner credentials (payme_client_key) from PayMe Partners - A default callback URL on your partner account, to receive seller callbacks ## Related - [Create sellers](https://docs.payme.io/marketplaces-and-platforms/seller-onboarding/create-seller) - [Create a seller](https://docs.payme.io/payments/merchants-management/post-create-seller) - [Upload seller files](https://docs.payme.io/payments/merchants-management/post-upload-seller-files) - [File types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/file-types) - [List sellers](https://docs.payme.io/payments/query-apis/post-get-sellers) - [Update a seller](https://docs.payme.io/payments/merchants-management/post-update-seller) - [Withdrawals](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/withdrawals) - [Platform fees](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/platform-fees) - [Start here: build a platform or marketplace on PayMe](https://docs.payme.io/marketplaces-and-platforms/start-here/how-platforms-work) - [Callbacks](https://docs.payme.io/payments/getting-started/callbacks) # Onboard a seller, from creation to first payout This guide follows one seller through its whole life on your platform: you create it, upload its documents, PayMe approves it, it takes its first payment and gets its first payout. Only partners onboard sellers, with their `payme_client_key`. For the two ways to create a seller and the fields PayMe's onboarding pages ask for, see [Create sellers](https://docs.payme.io/marketplaces-and-platforms/seller-onboarding/create-seller). ## The lifecycle at a glance | Stage | What you do | How you know it's done | |---|---|---| | 1. Collect the details | Your onboarding form | Nothing to check yet | | 2. Create the seller | [create-seller](https://docs.payme.io/payments/merchants-management/post-create-seller) | `seller_payme_id` in the response, then the `seller-create` callback | | 3. Upload the documents | [upload-seller-files](https://docs.payme.io/payments/merchants-management/post-upload-seller-files), or the seller uploads them on PayMe's onboarding pages | `status_code` `0` | | 4. Approval | Wait for PayMe's review | The `seller-approve` callback, and `seller_approved` `true` on [get-sellers](https://docs.payme.io/payments/query-apis/post-get-sellers) | | 5. Services | The seller installs payment methods, or you call `vas-enable` | [get-vas-seller](https://docs.payme.io/payments/merchants-management/post-get-vas-seller) lists them | | 6. First sale | [generate-sale](https://docs.payme.io/payments/hosted-payment-page/post-generate-sale) with the seller's MPL | The `sale-complete` callback | | 7. First payout | [withdraw-balance](https://docs.payme.io/payments/merchants-management/post-withdraw-balance), or automatic | The `withdrawal-complete` callback, then [get-withdrawals](https://docs.payme.io/payments/query-apis/post-get-withdrawals) | A seller can take payments from stage 2. Only the payout waits for approval. ## 1. Collect the seller's details - **Required fields:** PayMe sets which create-seller fields are required for your partner account. A missing one returns error `19`, and `status_additional_info` names it. `seller_email` is always required and must be unique among your sellers (error `150`). - **Your own ID:** send `seller_id` to find the seller by your ID later. It must be unique among your sellers (error `108`). - **Reference lists:** incorporation types per country on [Seller incorporation types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/seller-incorporation-types-il) (error `114`), business field codes on [List business fields](https://docs.payme.io/payments/merchants-management/get-business-fields) (error `110`), bank codes on [Banks in Israel](https://docs.payme.io/payments/codes-statuses/banks-in-israel) (error `106`). - **Dates:** `dd/mm/yyyy` with leading zeros, for example `06/05/1989`. - **Other people in the business:** owners, signatories and directors go in `seller_additional_details`, one object per person, with their roles from [Individual seller types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/individual-seller-types). ## 2. Create the seller Call [create-seller](https://docs.payme.io/payments/merchants-management/post-create-seller) from your server: ```bash curl -X POST https://sandbox.payme.io/api/create-seller \ -H 'Content-Type: application/json' \ -d '{ "payme_client_key": "XXXXXXXX", "seller_id": "store-1001", "seller_first_name": "Dana", "seller_last_name": "Levi", "seller_social_id": "9999999999", "seller_birthdate": "06/05/1989", "seller_social_id_issued": "01/02/2015", "seller_gender": 1, "seller_email": "random@paymeservice.com", "seller_phone": "+972501234567", "seller_bank_code": 54, "seller_bank_branch": 123, "seller_bank_account_number": "123456", "seller_site_url": "https://www.example.com", "seller_person_business_type": 205, "seller_inc": 1, "seller_merchant_name": "Dana Ceramics", "seller_address_city": "Tel Aviv", "seller_address_street": "Herzl", "seller_address_street_number": "10", "seller_address_country": "IL", "market_fee": 2.5, "language": "en" }' ``` The values `9999999999`, `random@paymeservice.com` and bank `54` are sandbox test values. Use the seller's real details in production. From the response: ```json { "status_code": 0, "session": "a1B2c3D4", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "seller_payme_secret": "Qw3rTy7uI9oP1aS5dF8gH2jK4lZ6xC", "seller_public_key": { "uuid": "12345678-1234-4abc-9def-123456789012", "description": "PayMe-Public-Key", "is_active": true }, "seller_id": "store-1001", "seller_dashboard_signup_link": "https:///" } ``` - Store `seller_payme_id` (the MPL) on your server. You send it on every call for this seller. - Store `seller_public_key.uuid` for the seller's browser code. - Send the seller `seller_dashboard_signup_link`, exactly as returned. There the seller sets a password and finishes onboarding. - Ignore `seller_payme_secret`: it isn't a credential. The call is limited to 5 requests per minute per IP. Over the limit, or while a call for the same `seller_email` is still running, it returns HTTP 429 with error `998`: wait and retry. A partner sets the seller's default platform fee here with `market_fee`; it can't be changed later with update-seller. See [Platform fees](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/platform-fees). ## 3. Upload the documents PayMe approves a seller only after it has checked the seller's documents. Use the codes on [File types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/file-types): | Seller | Files | |---|---| | Every seller | `1` social ID and `2` bank account ownership | | Every seller except a private individual, a House Committee, and Municipalities and councils | Also `3` corporate certificate | | A House Committee | Also `14` authorized signer protocol and `7` processing agreement | | Municipalities and councils | Also `27` origin tax confirmation and `7` processing agreement | | Some services and partner accounts | Also `7` or `29`. Your account manager will tell you. | There are three ways to send them: - **[upload-seller-files](https://docs.payme.io/payments/merchants-management/post-upload-seller-files):** one or more files, each as a public `url` or as `base64` content. - **On create-seller:** public URLs in `seller_file_social_id` (type `1`), `seller_file_cheque` (type `2`) and `seller_file_corporate` (type `3`). PayMe downloads them in the background. - **The seller uploads them** on PayMe's onboarding pages, through `seller_dashboard_signup_link`. ```json { "payme_client_key": "XXXXXXXX", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "seller_files": [ { "name": "social_id.pdf", "type": 1, "url": "https://www.example.com/files/social_id.pdf", "mime_type": "application/pdf" } ], "language": "en" } ``` Personal documents (types `90`–`97`, such as the front and back of an ID) belong to a person: - In `seller_additional_details[].files` on create-seller, they are attached to that person. - With upload-seller-files, they are attached to the seller's primary individual. If the seller has more than one individual, the call fails with error `184`. Allowed file types and the upload errors (`904`, `905`, `909`) are on [upload-seller-files](https://docs.payme.io/payments/merchants-management/post-upload-seller-files). ## 4. Verification and approval PayMe reviews the seller's details and documents. You learn the result from seller callbacks and from get-sellers. ### Seller callbacks PayMe sends these callbacks to your partner account's default callback URL as a form-encoded `POST`. Each carries the seller's details (`seller_payme_id`, `seller_id`, `seller_active`, `seller_approved` and more): see [Callbacks → Sellers](https://docs.payme.io/payments/getting-started/callbacks#sellers-partners). | `notify_type` | When PayMe sends it | |---|---| | `seller-create` | The seller was created. Also carries `seller_public_key`. | | `seller-update` | The seller changed: after update-seller, when PayMe records the result of a check on the seller, and when the seller's approval changes. | | `seller-approve` | PayMe approved the seller. Also carries `partner_name`. | - When PayMe approves a seller, it sends both `seller-approve` and `seller-update`. They can arrive in any order. - A `seller-update` during the review isn't an approval. Wait for `seller-approve`, or for `seller_approved` `1`. - Seller callbacks carry no signature. Treat each one as a prompt: read the seller with get-sellers and act on what it returns. - If your partner account has no default callback URL, PayMe sends no seller callbacks. Ask PayMe Partners to set one, or check get-sellers. ### Check the seller's state Call [get-sellers](https://docs.payme.io/payments/query-apis/post-get-sellers) with the seller's MPL: ```json { "payme_client_key": "XXXXXXXX", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "api_mode": "slim" } ``` | Field | Meaning | |---|---| | `seller_approved` | `true` once PayMe has approved the seller. Withdrawals need it. | | `seller_approved_date` | When PayMe approved the seller, or `null` | | `seller_active` | `true` if the seller is active | To list every seller that is still waiting, send `payme_client_key` with `"seller_approved": false`. ### If a document is declined Upload a corrected file with the same type. If a required document is declined after the seller was approved, the seller loses its approval: you get a `seller-update` with `seller_approved` `0`, and withdrawals fail with error `109` until PayMe approves the seller again. ### Before and after approval | | Before approval | After approval | |---|---|---| | Take payments | Yes | Yes | | Request a withdrawal | No, error `109` | Yes, if the seller is active, has bank details and has released funds | ## 5. Turn on payment methods and services - **Apple Pay, Google Pay, Bit:** the seller installs them from the dashboard app store (חנות אפליקציות), or you enable them with `vas-enable`. See [Accept Apple Pay](https://docs.payme.io/accepting-payments/payment-methods/apple-pay) and [Accept Google Pay](https://docs.payme.io/accepting-payments/payment-methods/google-pay). A sale with a method the seller doesn't have fails with error `720`. - **3D Secure:** enabled on the seller's account by PayMe. - **Check:** [get-vas-seller](https://docs.payme.io/payments/merchants-management/post-get-vas-seller) lists the services installed on the seller. Service types are on [VAS types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/vas-types). ## 6. Take the first sale Create the sale with the seller's MPL, from your server. Add `market_fee` to override the seller's default fee for this sale. The full example is on [Start here: build a platform or marketplace on PayMe](https://docs.payme.io/marketplaces-and-platforms/start-here/how-platforms-work), and the fee rules on [Platform fees](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/platform-fees). ## 7. Get the first payout How the seller is paid depends on `seller_withdrawal_plan` on get-sellers. A new seller starts on your partner account's default plan: | Plan | How the seller is paid | |---|---| | `1` manual | You request each withdrawal with withdraw-balance | | `2` automatic, daily | PayMe pays out by itself. withdraw-balance returns error `907`. | | `3` automatic, monthly | PayMe pays out on `seller_withdrawal_date`. withdraw-balance returns error `907`. | A seller paid directly by the card companies gets its money from them, and withdraw-balance returns error `908`. Before the first withdrawal, check that: - the seller is approved (otherwise error `109`) and has bank details on file (otherwise error `165`); - `seller_wallets..wallet_releasable` on get-sellers is above zero. It isn't returned with `api_mode` `slim`. Each sale's `sale_release_date` on get-sales tells you when its money is released; - the released balance reaches the minimum, by default 100.00 in the currency (otherwise error `913`). On plan `1`, request the withdrawal: ```json { "payme_client_key": "XXXXXXXX", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "withdrawal_currency": "ILS" } ``` This withdraws the whole released balance in that currency. When the withdrawal is recorded, PayMe sends `withdrawal-complete` to your default callback URL, before the bank transfer arrives. Read the final amount from get-withdrawals. Partial withdrawals, specific transactions, the callback fields and every error are on [Withdrawals](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/withdrawals). In the sandbox, sellers start on an automatic plan: ask PayMe to set up a test seller before you test a withdrawal. ## Change a seller later Call [update-seller](https://docs.payme.io/payments/merchants-management/post-update-seller) with `payme_client_key`, the seller's MPL (or your `seller_id`) and only the fields you want to change. PayMe then sends `seller-update`. - PayMe sets which fields stay locked once they have a value. Changing one returns error `33`. - `seller_additional_details` adds people. It doesn't change or remove the people already on file. - The seller's default `market_fee` can't be changed with update-seller. Contact PayMe Partners (). ## Fees and Payouts - [Platform fees](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/platform-fees): How a partner charges a platform fee on its sellers' sales. market_fee is a percent (0-60) set as the seller's default on create-seller or per sale on generate-sale; market_fee_fixed adds a fixed fee per sale in major units. Errors 304 and 308. The seller's default can't be changed with update-seller; contact PayMe. See the fee on get-sellers, get-sales and get-transactions. ## Related - [Reconcile sales and withdrawals](https://docs.payme.io/accepting-payments/reporting/reconcile-sales-and-withdrawals) - [Withdrawals](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/withdrawals) # Platform fees ## What market_fee is `market_fee` is the percent of each sale price that PayMe collects from the seller for you, the platform. It comes on top of PayMe's own fees. The buyer pays the same price. - **Units:** a percent, not minor units. `2.5` means 2.5%. - **Range:** 0 to 60. - **VAT:** the percent includes VAT. PayMe adds none on top. - **Payout:** by default, the fee is transferred to the marketplace once a month. The seller's balance is already net of it. On a sale of `10000` (100.00) with `market_fee` `2.5`, the fee is `250` (2.50). ## Set a default for a seller Send `market_fee` on [Create a seller](https://docs.payme.io/payments/merchants-management/post-create-seller). Without it, the seller's default is `0`. A value outside 0–60 returns error `304`. The default can't be changed with [Update a seller](https://docs.payme.io/payments/merchants-management/post-update-seller). To change a seller's default later, contact PayMe Partners (). Until it's changed, set the fee on each sale with `market_fee`, as shown below. A change to the default affects future sales only. Each sale keeps the fee it had when it was generated, including an authorization that hasn't been captured yet. ## Set the fee on one sale Send `market_fee` on [Generate Payment](https://docs.payme.io/payments/hosted-payment-page/post-generate-sale) to override the seller's default for that sale. Without it, the sale uses the seller's default. Send `0` to charge no fee on that sale. ```json { "payme_client_key": "XXXXXXXX", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_price": 10000, "currency": "ILS", "product_name": "Monthly plan", "transaction_id": "order-1001", "sale_callback_url": "https://example.com/payme/callback", "sale_return_url": "https://example.com/thanks", "market_fee": 2.5 } ``` ## Add a fixed fee per sale Send `market_fee_fixed` on generate-sale to add a fixed fee to the percent on that sale. Unlike other amounts in the API, it is in **major units**: `2.5` means 2.50. The percent and the fixed fee are added together. On a sale of `10000` (100.00) with `market_fee` `2.5` and `market_fee_fixed` `1`, the fee is `350` (3.50). The percent plus the fixed fee, taken as a percent of the sale price, can't be more than 60%. | Error | Meaning | | --- | --- | | `10` | `market_fee` is not a number | | `304` | `market_fee` is negative, or `market_fee_fixed` is negative or not a number | | `308` | `market_fee` plus `market_fee_fixed` is above 60% of the sale price | ## Sellers paid directly Setting the fee on a sale isn't supported for sellers the card companies pay directly: the seller's default applies, whatever the sale sends. Contact PayMe to arrange platform fees for these sellers. ## See what was charged | Where | Field | Meaning | | --- | --- | --- | | [get-sellers](https://docs.payme.io/payments/query-apis/post-get-sellers) | `seller_fees.fee_market_fee` | The seller's default percent. Use it to confirm a change took effect. You can also filter on `fee_market_fee` | | [get-sales](https://docs.payme.io/payments/query-apis/post-get-sales) | `sale_fees.sale_market_fee`, `sale_fees.sale_market_fee_fixed` | The percent, and the fixed fee in major units, on this sale | | [get-transactions](https://docs.payme.io/payments/query-apis/post-get-transactions) | `sale_fees.sale_market_fee_total` | The fee on this transaction's amount in minor units: the percent part plus the fixed part | On `get-transactions`, a partial refund's `sale_market_fee_total` is worked out from the refunded amount, so it shows the fee on that part of the sale. Whether a seller gets fees back on a refund depends on the seller's account settings. - [Withdrawals](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/withdrawals): How sellers get paid. seller_withdrawal_plan 1 (manual) sellers request payouts with withdraw-balance (whole released balance, withdrawal_amount, or transaction_ids); plans 2 and 3 are automatic (error 907); paid-directly sellers get error 908. The seller must be approved by PayMe (error 109). Track with get-withdrawals and get-future-withdrawals; the withdrawal-complete callback; common errors. ## Related - [Reconcile sales and withdrawals](https://docs.payme.io/accepting-payments/reporting/reconcile-sales-and-withdrawals) - [Platform fees](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/platform-fees) # Withdrawals ## How sellers get paid A withdrawal moves a seller's released balance to its bank account. How it starts depends on `seller_withdrawal_plan` on [get-sellers](https://docs.payme.io/payments/query-apis/post-get-sellers), and on whether the card companies pay the seller directly: | Seller | How money arrives | Can request a withdrawal | | --- | --- | --- | | `seller_withdrawal_plan` `1` | Manual: you request each withdrawal | Yes | | `seller_withdrawal_plan` `2` | Automatic, daily | No, error `907` | | `seller_withdrawal_plan` `3` | Automatic, monthly on `seller_withdrawal_date` | No, error `907` | | Paid directly by the card companies (`withdrawable` is `0` on get-future-withdrawals) | The card companies pay the seller directly | No, error `908` | A new seller takes the partner's default plan, and no API field changes it. Every seller created on the sandbox test account came back on plan `2`, so PayMe has to set up a test seller before a withdrawal can succeed there. ## Before the first withdrawal Funds can't be withdrawn until PayMe approves the seller. Until then, withdraw-balance returns error `109`. `seller_approved` on get-sellers shows the approval, and a partner receives the `seller-approve` [callback](https://docs.payme.io/payments/getting-started/callbacks). Approval needs the seller's documents. Upload them with [Upload seller files](https://docs.payme.io/payments/merchants-management/post-upload-seller-files), using the codes on [File types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/file-types): | Document | Code | Needed by | | --- | --- | --- | | Social ID | `1` | Every seller | | Bank account ownership | `2` | Every seller | | Corporate certificate | `3` | Every seller except a private individual, a house committee or a municipality | Some business types need more documents. File types lists them. The seller must also be active and have bank details on file. Approval holds back payouts, not payments: a new seller can start taking payments while it waits. Show sellers their approval state early, and send them the `seller_dashboard_signup_link` that [Create a seller](https://docs.payme.io/payments/merchants-management/post-create-seller) returns so they can finish onboarding. ## Check the balance There is no separate balance call. `seller_wallets` on get-sellers holds each currency's balance, in minor units. It isn't returned when you send `api_mode` `slim`. | Field | Meaning | | --- | --- | | `wallet_total` | Everything PayMe holds for the seller | | `wallet_releasable` | The part past its release date | | The difference | Funds not released yet. `sale_release_date` on [get-sales](https://docs.payme.io/payments/query-apis/post-get-sales) gives each sale's date | Check `seller_approved` as well: a positive `wallet_releasable` doesn't mean the seller can withdraw. ## Request a withdrawal Call [withdraw-balance](https://docs.payme.io/payments/merchants-management/post-withdraw-balance) with one currency. A partner sends `payme_client_key` and `seller_payme_id`. ```json { "payme_client_key": "XXXXXXXX", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "withdrawal_currency": "ILS" } ``` This withdraws the whole released balance in that currency. To withdraw a set amount instead, add `withdrawal_amount` in minor units. It must be at least the minimum and no more than the released balance. The response identifies the withdrawal: ```json { "status_code": 0, "page": 1, "items_per_page": 1, "items_total": 1, "items": [ { "withdrawal_id": 10001, "withdrawal_currency": "ILS", "withdrawal_total": 600000 } ] } ``` If `items` is empty, no withdrawal was created. PayMe finishes a whole-balance withdrawal in the background, so the amount can change and a failed withdrawal is removed. Read the final amount from get-withdrawals. If the call times out or the connection drops, PayMe may still have acted. Check [get-withdrawals](https://docs.payme.io/payments/query-apis/post-get-withdrawals) before you retry: there is no idempotency key. ## Withdraw specific transactions To withdraw only some transactions, add `transaction_ids` with `payme_transaction_id` values from [get-transactions](https://docs.payme.io/payments/query-apis/post-get-transactions): ```json { "payme_client_key": "XXXXXXXX", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "withdrawal_currency": "ILS", "transaction_ids": ["TRANDEMO-XXXXXXXX-XXXXXXXX-XXXXXXXX"] } ``` Every transaction must belong to the seller, be in the withdrawal currency, be released and not be withdrawn already. PayMe also takes in the released, unwithdrawn transactions on the same sales, such as a refund. `transaction_ids` in the response lists every transaction involved, so it can hold more IDs than you sent. ## Track withdrawals | To see | Call | Fields | | --- | --- | --- | | Past withdrawals | [get-withdrawals](https://docs.payme.io/payments/query-apis/post-get-withdrawals) | `withdrawal_payme_code`, `withdrawal_created`, `withdrawal_currency`, `withdrawal_total`, `withdrawal_source`, `withdrawal_card_brand` | | Upcoming withdrawals | [get-future-withdrawals](https://docs.payme.io/payments/query-apis/get-future-withdrawals) | `created_at`, `total`, `start_time`, `end_time`, `withdrawable` | - **get-withdrawals:** a seller sees its own withdrawals. A partner sees all its sellers, or those named in `seller_payme_id`. The response has no status for the bank transfer. - **get-future-withdrawals:** send `seller_payme_id` and `currency`, both required, for one seller per request. An item with `end_time` `-1` covers everything after the listed periods. `withdrawal_payme_code` on this call doesn't match the code on get-withdrawals. ## Callback PayMe sends `withdrawal-complete` to the partner's default [callback](https://docs.payme.io/payments/getting-started/callbacks) URL when the withdrawal is recorded, which is before the bank transfer arrives. Treat it as a prompt: read get-withdrawals and act on what that returns. De-duplicate on `tran_payme_code`. | Field | Example | Meaning | | --- | --- | --- | | `notify_type` | `withdrawal-complete` | Type of callback | | `payme_status` | `success` | Always `success` for this callback | | `status_code` | `0` | `0` for success | | `status_error_code` | `0` | `0` for success | | `seller_payme_id` | `MPLDEMO-MPLDEMO-MPLDEMO-1234567` | The seller | | `seller_id` | `store-1001` | Your own ID for the seller, if you set one | | `sale_payme_code` | `0` | Always `0` | | `tran_payme_code` | `10001` | The same number as `withdrawal_payme_code` | | `tran_created` | `2026-11-03 15:15:15` | Withdrawal time, Asia/Jerusalem | | `tran_type` | `40` | Bank withdrawal | | `tran_currency` | `ILS` | Currency | | `tran_total` | `600000` | Amount in minor units | | `tran_description` | (Hebrew text) | A Hebrew label. Don't parse it | ## Common errors Branch on `status_error_code`, as described on [Errors](https://docs.payme.io/payments/getting-started/errors). | Code | Meaning | What to do | | --- | --- | --- | | `2` | A previous withdrawal is stuck on a funds mismatch | Contact PayMe support | | `17` | More than one currency was sent | Send one currency per request | | `42` | `withdrawal_amount` isn't an integer | Send the amount in minor units, as an integer | | `109` | The seller isn't approved yet | Complete document verification and approval | | `165` | Bank details are missing | Update the seller's bank details | | `171` | No funds available to withdraw, or `withdrawal_amount` is above them | Check `wallet_releasable` and try after funds are released | | `252` | Unknown `withdrawal_currency` | Send a 3-letter currency code, such as `ILS` | | `907` | The seller is on an automatic plan | Don't call withdraw-balance; track with the query APIs | | `908` | The seller is paid directly | Money comes from the card companies | | `913` | Amount is below the minimum | Wait until the released balance reaches the minimum, by default 100.00 in the currency | | `998` | HTTP 429: a withdrawal for this seller is still running | Retry later, after checking get-withdrawals | | `507` | A listed transaction is in another currency | Send one currency per request | | `523` | A listed transaction isn't released yet | Retry after `transaction_release_date` | | `525` | A listed transaction was already withdrawn | Remove it from `transaction_ids` | | `526` | A listed transaction wasn't found | Check the IDs and the seller | ## Seller Reference - [File types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/file-types): Reference list of seller document type codes for upload-seller-files and seller_additional_details[].files[].type. Every seller needs 1 (ID) and 2 (bank account); 3 (corporate certificate) for all but private individuals, house committees and municipalities, which need 14+7 and 27+7. Codes 90-97 are individual documents attached to the seller's primary individual (error 184 with more than one individual). Unknown code: error 20. # File types Use these codes as `type` when you upload seller documents with [Upload seller files](https://docs.payme.io/payments/merchants-management/post-upload-seller-files), or in `seller_additional_details[].files[]` on [Create a seller](https://docs.payme.io/payments/merchants-management/post-create-seller). An unknown code fails with error `20`. This page lists the file types partners normally upload. Your account manager may ask for others. ## Required files PayMe approves a seller, and releases its payouts, only after it has checked the seller's documents. See [Withdrawals](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/withdrawals). - Every seller needs `1` (social ID) and `2` (bank account ownership). - Every seller except a private individual, a House Committee or Municipalities and councils also needs `3` (corporate certificate). - A House Committee also needs `14` (authorized signer protocol) and `7` (processing agreement). - Municipalities and councils also need `27` (origin tax confirmation) and `7`. - Some services and partner accounts also require `7` or `29` (credit voucher discount agreement). Your account manager will tell you. ## Seller files and individual files Codes `90`–`97` are individual documents. Upload seller files attaches them to the seller's primary individual, and the upload fails with error `184` if the seller has more than one individual. All other codes are attached to the seller. In `seller_additional_details[].files[]` on Create a seller, only codes `90`–`97` are accepted (error `160`). ## Codes | Code | Name | Description | | --- | --- | --- | | `1` | Social ID | Social ID document (תעודת הזהות) | | `2` | Bank account ownership | Proof of bank account ownership or a photo of a cancelled cheque (שיק מבוטל או אישור ניהול חשבון בנק) | | `3` | Corporate certificate | Incorporation document (תעודת התאגדות של עוסק פטור/עוסק מורשה/חברה בע"מ/עמותה) | | `4` | Bank authorization | Bank authorization (הרשאה לחיוב חשבון) | | `5` | Personal guarantee | Personal guarantee (ערבות אוואל). Upload only if your account manager asks for it | | `6` | Promissory note | Promissory note (שטר חוב). Upload only if your account manager asks for it | | `7` | Processing agreement | Processing agreement (הסכם סליקה). Required for some business types and services, see above | | `8` | Signature | Signature (חתימה). Upload only if your account manager asks for it | | `9` | Stamp | Stamp (חותמת). Upload only if your account manager asks for it | | `11` | Additional license | Additional license (רשיון נוסף). Upload only if your account manager asks for it | | `12` | Public representative | Public representative statement (הצהרת איש ציבור). Upload only if your account manager asks for it | | `13` | Regulatory authentication | Company extract or BDI report (נסח חברה או BDI). Upload only if your account manager asks for it | | `14` | Authorized signer protocol | Authorized signer protocol (פרוטוקול מורשי חתימה). Required for a House Committee | | `15` | Business proof | Business proof document (אישור עסק). Upload only if your account manager asks for it | | `16` | Service receiver | Service receiver statement (הצהרת מקבל שירות). Upload only if your account manager asks for it | | `17` | Face-to-face approval | Face-to-face identification approval (אישור זיהוי פנים מול פנים). Upload only if your account manager asks for it | | `18` | False statement of information | False statement of information (הצהרת מידע כוזב). Upload only if your account manager asks for it | | `19` | Bank statement | Bank statements for the last 3 months | | `20` | Processing history | Credit card processing history | | `21` | Tax return | Tax return | | `22` | Inventory proof | Proof of inventory | | `23` | Company logo | Company logo image. Upload only if your account manager asks for it | | `24` | Driving license | Driving license (רשיון נהיגה). Used when you onboard Keep sellers | | `25` | Social ID appendix | Social ID appendix (ספח תעודת זהות). Used when you onboard Keep sellers | | `26` | Passport | Passport (דרכון). Used when you onboard Keep sellers | | `27` | Origin tax confirmation | Tax deduction at source confirmation (אישור ניכוי מס במקור). Used when you onboard Keep sellers, and required for Municipalities and councils | | `28` | Bookkeeping certificate | Bookkeeping certificate (אישור ניהול ספרים). Used when you onboard Keep sellers | | `29` | Credit voucher discount agreement | Agreement for credit voucher discount. Required for some services, see above | | `30` | Passport, color, front | Color scan of the front of the passport | | `31` | Passport, color, back | Color scan of the back of the passport | | `32` | Professional license | An image of a professional license | | `33` | Ministry certificate | An image of a ministry certificate | | `34` | Copyright | An image of a copyright certificate | | `35` | Lease | An image of the lease agreement of the business | | `90` | Social ID front | Individual: an image of the front of a social ID | | `91` | Social ID back | Individual: an image of the back of a social ID | | `92` | Passport front | Individual: an image of the front of the passport (דרכון) | | `93` | Passport back | Individual: an image of the back of the passport | | `94` | Driving license front | Individual: an image of the front of a driving license (רשיון נהיגה) | | `95` | Driving license back | Individual: an image of the back of a driving license | | `96` | Selfie | Individual: a selfie for face-to-face identification | | `97` | Video recording | Individual: a video recording for face-to-face identification | | `100` | PayMe | Acquirer-specific form. Upload only if your account manager asks for it | | `101` | Isracard | Acquirer-specific form. Upload only if your account manager asks for it | | `102` | Tzameret | Acquirer-specific form. Upload only if your account manager asks for it | | `103` | Cal | Acquirer-specific form. Upload only if your account manager asks for it | | `104` | ECom | Acquirer-specific form. Upload only if your account manager asks for it | | `105` | CardCom | Acquirer-specific form. Upload only if your account manager asks for it | - [Business field codes (MCC)](https://docs.payme.io/marketplaces-and-platforms/seller-reference/mcc-list): Reference list of PayMe business field codes (10000 and up, top-level fields and their children) with Hebrew and English names. Send the code as seller_person_business_type on create-seller or update-seller; an unknown or inactive code returns error 110. The live list is GET /business-fields (allow_children=true for child codes). The Hebrew name is authoritative. # Business field codes (MCC) Send one of these codes as `seller_person_business_type` when you [create](https://docs.payme.io/payments/merchants-management/post-create-seller) or [update](https://docs.payme.io/payments/merchants-management/post-update-seller) a seller. An unknown or inactive code fails with error `110`. If you send `seller_inc` without `seller_person_business_type`, the seller gets code `205`. These are PayMe business field codes. PayMe maps each one to the card companies' own merchant category codes. Codes are grouped: each top-level field (for example `10000` Nurseries) has more specific child fields (`10001`–`10003`). Some child codes have the same name as their parent. To get the live list, call [`GET /business-fields`](https://docs.payme.io/payments/merchants-management/get-business-fields). It returns top-level fields only; add `allow_children=true` to get all of them. Older sellers may have a code below 10000. Most of those codes are still accepted, but use a code from this list for new sellers. If an English name doesn't match the Hebrew name, the Hebrew name is correct. | Code | Name (Hebrew) | Name (English) | | --- | --- | --- | | 10000 | משתלות | Nurseries | | 10001 | משתלות רגילות | Ordinary nurseries | | 10002 | משתלות יצרניות | Manufacturers' nurseries | | 10003 | משתלות מעורבות | Multi-Purpose nurseries | | 10004 | קונדיטוריה | Confectionery | | 10005 | קונדיטוריה-קונדיטוריות לייצור עצמי ומכירה במקום | Confectionery-confectionery for self-production and sale instead | | 10006 | קונדיטוריה-קונדיטוריות לייצור עצמי ומכירה במספר מוקדים | Confectionery-confectionery for self-production and selling in several focal points | | 10007 | קונדיטוריה לייצור עצמי בתוספת בית קפה | Self -production confectionery plus a cafe | | 10008 | קונדיטוריה בייצור סיטונאי | Confectionery in wholesale production | | 10009 | מאפיה | bakery | | 10010 | מאפיות קטנות | Small bakery | | 10011 | מאפיות בינוניות | Medium bakeries | | 10012 | מאפיות גדולות | Large bakery | | 10013 | מאפיות פיתות | Pites bakery | | 10014 | ייצור ופלים ועוגיות | Waffles and Cookies Manufacturing | | 10015 | פאות | Wigs | | 10016 | פאות-חנויות לאוכלוסייה החרדית\דתית | Wigs-shops for the ultra-Orthodox / religious population | | 10017 | פאות-חנויות לכלל האוכלוסיה | Wigs-stores for the general population | | 10018 | מסגריות | Locksmiths | | 10019 | מסגריות מכניות-עיבוד שבבי | Mechanical cargo-chip processing | | 10020 | מוסכים | Garages | | 10021 | אביזרי רכב | car accessories | | 10022 | אביזרי רכב-מוצרי מדף כללים | Automotive accessories-products | | 10023 | אביזרי רכב-מצברים | Car accessories | | 10024 | אביזרי רכב-נורות | Car-Lamp accessories | | 10025 | אביזרי רכב-התקנת מערכות: רדיו דיסק, מולטימדיה | Car Accessories-Systems Installation: Disk Radio, Multimedia | | 10026 | אביזרי רכב: דיבורית B.T | Car Accessories: B.T Handle | | 10027 | אביזרי רכב: חיישני נסיעה לאחור | Automotive Accessories: Rehole | | 10028 | אביזרי רכב: קודן | Car Accessories: Coden | | 10029 | אביזרי רכב: כספת | Car Accessories: Safe | | 10030 | אביזרי רכב: מצלמת דרך | Car Accessories: Camera | | 10031 | מעדניה | deli | | 10032 | ספרים | Books | | 10033 | ספרים-חנויות לספרי קריאה ועיון | Books-stores for reading and reference books | | 10034 | ספרים-חנויות לספרי לימוד בלבד | Books-stores for textbooks only | | 10035 | ספרים-חנויות לספקי קריאה ועיון ולספרי לימוד | Books-stores for reading and seminar and textbooks | | 10036 | הלבשת גברים - חנויות אופנה | Men's Clothing- fashion shops | | 10037 | הלבשת גברים - חנויות הלבשה | Men's Clothing - dressing shops | | 10038 | הלבשת גברים - חנויות בזאר | Men's Clothing - Bazaar shops | | 10039 | הלבשת גברים - יבואנים | Men's Clothing - Importing | | 10040 | הלבשת גברים - בתי אופנה יוקרתיים | Men's Clothin - luxury fashion houses | | 10041 | הלבשת ילדים ונוער- חנויות הלבשה | Dressing Children and Youth- Clothing stores | | 10042 | הלבשת ילדים ונוער - חנויות באזר | Children and Youth Clothing - Baza Stores | | 10043 | הלבשת ילדים ונוער - יבואנים | Children and Youth Clothing - Importing | | 10044 | הלבשת ילדים ונוער - בתי אופנה יוקרתיים | Children and Youth - Luxury Fashion Homes | | 10045 | הלבשת נשים - בתי אופנה יוקרתיים | Women's Clothing- Luxury Fashion Homes | | 10046 | הלבשת נשים - חנויות אופנה | Women's Clothing - Fashion Stores | | 10047 | הלבשת נשים - חנויות הלבשה | Women's Clothing - Clothing stores | | 10048 | הלבשת נשים - חנויות בזאר | Women's Clothing - Bazaar shops | | 10049 | הלבשת נשים - יבואנים | Dressing Women - Importers | | 10050 | חנויות הלבשת נשים עליונה | Supreme Women's Clothing stores | | 10051 | כובעים - חנויות בערי הפריפריה | Hats - shops in peripheral cities | | 10052 | כובעים - חנויות בערים הגדולות והבינוניות וחנויות האופנה | Hats - shops in the big and medium cities and fashion stores | | 10053 | כובעים - פריטים נלווים | Hats - related items | | 10054 | הלבשה תחתונה | Lingerie | | 10055 | גלריות | Galleries | | 10056 | תערוכות | Exhibitions | | 10057 | מסגרות לתמונות | picture frames | | 10058 | עתיקות ותשמישי קדושה | Antiquities and Saint Grace | | 10059 | עתיקות ותשמישי קדושה-חנות עממית | Antiquities and Popular Saint-Store | | 10060 | עתיקות ותשמישי קדושה-חנות עממית המתמחה בשיווק טליתות | Antiquities and Holy Holocaust-Popular Store specializing in Talit Marketing | | 10061 | עתיקות ותשמישי קדושה-חנות יוקרתית | Antiques and prestigious holy-stores | | 10062 | אופטיקה | optics | | 10063 | אופטיקה-עדשות | Optics-lenses | | 10064 | אופטיקה-מסגרות | Optics-frames | | 10065 | אופטיקה-זוג משקפיים (מסגרת+עדשות) | Optics-Corporate Glasses (Frame+Lens) | | 10066 | אופטיקה-עדשות מגע | Optics-Touch Lens | | 10067 | ואופטומטריסט | And optometrist | | 10068 | מצלמות וצרכי צילום | Cameras and photography needs | | 10069 | צלמים | Photographers | | 10070 | צילום-חנויות עם "מעבדה זעירה" לפיתוח סרטי צילום והדפסת תמונות | Store photography with "Tiny Laboratory" for developing photo films and printing photos | | 10071 | צילום-חנויות עם שירותי מעבדה חיצונית לפיתוח סרטי צילום והדפסת תמונות | Photo-store with external laboratory services for developing photo films and printing photos | | 10072 | צילום-שכפול מסמכים וצילומי פספורט | Photo-Duplicate Documents and Passport Photography | | 10073 | חיות | Animals | | 10074 | שירותי פנסיון ואילוף לחיות מחמד | Petal and pet training services | | 10075 | חיות בית-טיפול וסיוע | Home-the-handle and assistance | | 10076 | חיות בית-טיפול וסיוע-חנויות המתמחות במכירת מזון בלבד | Home-handling and assistance-stores specializing in food sale only | | 10077 | חיות בית-טיפול וסיוע-חנויות באזורים יוקרתיים | Home-handling and shop assistance in prestigious areas | | 10078 | חיות בית-טיפול וסיוע-חנויות שכיחות | Home-handed and store assistance is common | | 10079 | מגרשי מכוניות משומשות | Used car fields | | 10080 | סוכני רכב למשומשות | Car agents for used | | 10081 | מסחר בכלי רכב משומשים-יבואנים וסוכנויות למכירת רכב חדש | Used vehicles-imported vehicles and new car sales agencies | | 10082 | מסחר בכלי רכב משומשים-קבלני משנה של היבואנים | Trade in used-to-contract vehicles of importers | | 10083 | מסחר בכלי רכב משומשים-חברות הליסינג התפעולי וההשכרה | Trade in used vehicles-operating leasing companies and rental | | 10084 | מסחר בכלי רכב משומשים-סוחרי רכב פרטיים בעלי מגרש | Trade in used vehicles-traded car dealers with plot | | 10085 | מסחר בכלי רכב משומשים-סוחרי רכב פרטיים ללא מגרש | Trading in used-traded vehicles without a lot | | 10086 | חניוני רכב | Car parking lots | | 10087 | חניונים | Parking lots | | 10088 | פיצריות | Pizzas | | 10089 | מסעדות מזון מהיר | Fast food restaurants | | 10090 | בתי קפה | Coffee shops | | 10091 | בניית אתרי אינטרנט | Building websites | | 10092 | עו"ד | More | | 10093 | אדריכלים | Architects | | 10094 | מעצבי פנים | interior designers | | 10095 | וטרינר | veterinarian | | 10096 | השכרת רכב | Car Rental | | 10097 | סלון לכלות | A bridal salon | | 10098 | גננים-עבודות הקמה של גנים | Gardens-Labor Establishment of Gardens | | 10099 | גננים-עבודת אחזקה של גנים | Gardens-Gardens Maintenance Labor | | 10100 | גני ילדים וצהרונים | Kindergartens and Haruns | | 10101 | בית ספר לנהיגה | Driving school | | 10102 | רופאי שיניים | Dentists | | 10103 | רופאי שיניים אורתודנטיים | Orthodontic dentists | | 10104 | רפואת שיניים | dentistry | | 10105 | בתי אבות | Retirement homes | | 10106 | שירותי סיעוד | Nursing services | | 10107 | לשכות פרטיות להבאה, לתיווך ולטיפול בעובדים זרים בענף הסיעוד | Private bureaus to bring, mediation and handling foreign workers in the nursing industry | | 10108 | מכוני כושר | Gyms | | 10109 | מכבסות וניקוי יבש | Laundry and dry cleaning | | 10110 | מכוני יופי | Beauty Institutes | | 10111 | מספרות | Hairdressers | | 10112 | מספרות גברים | Men's hairdressers | | 10113 | ספא | spa | | 10114 | אביזרי אופנה | fashion accessories | | 10115 | אהילים ונברשות | Lampshades and chandeliers | | 10116 | חנויות כלי בית ומתנות | Housewives and Gifts | | 10117 | חנויות כלי בית ומתנות-חנויות פשוטות | Housewives and simple gifts | | 10118 | חנויות כלי בית ומתנות-חנויות בינוניות | Housewives and Medium Gifts | | 10119 | חנויות כלי בית ומתנות-חנויות יוקרה ורשתות לכלי בית | Housewares and Gifts-Luxury Stores and Networks for Home Tools | | 10120 | מסחר קמעוני במתנות לגבר | Retail trading in men's gifts | | 10121 | אולמי שמחות | A happy hall | | 10122 | אופטומטריסט | Optometrist | | 10123 | אופניים | Bicycle | | 10124 | מכירה ותיקון אופניים | Bicycle Sales and repair | | 10125 | מכירה ותיקון אופניים-חנויות המתמקצעות באופניים חשמליים בלבד | Sales and repair-stores that specialize in electric bicycles only | | 10126 | מכירה ותיקון אופניים-חנויות מעורבות לאופניים חשמליים ורגילים | Sales and repair bicycle-stores mixed to electric and normal bicycles | | 10127 | מכירה ותיקון אופניים-חנויות המתמקדות באופניים רגילים בלבד | Sales and repair-store-focusing on ordinary bicycles only | | 10128 | מסחר קמעוני במוצרי ספורט ובמוצרי מחנאות | Retail trading in sports and camping products | | 10129 | מסחר קמעוני במוצרי ספורט ובמוצרי מחנאות-חנויות יוקרתיות | Retail trade in sports products and in prestigious stores | | 10130 | מסחר קמעוני במוצרי ספורט ובמוצרי מחנאות-חנויות בינוניות | Retail trade in sports products and in medium stores | | 10131 | מסחר קמעוני במוצרי ספורט ובמוצרי מחנאות-חנויות קטנות | Retail trade in sports products and in small stores | | 10132 | טיולים | Tours | | 10133 | אכסניות וכפרי נופש | Hostels and resorts | | 10134 | בתי"ס שדה | SUPS CBS | | 10135 | צימרים, דירות ובתי הארחה | Zimmer, apartments and guest houses | | 10136 | בתי הבראה ומרגוע | Houses of recovery and relaxation | | 10137 | בתי מלון | Hotels | | 10138 | ארנק אלקטרוני | Electronic wallet | | 10139 | נש"מים | UAV | | 10140 | ארנקים ותיקים | Veteran wallets | | 10141 | מזודות | baggage | | 10142 | בדים וטכסטיל | Fabric | | 10143 | מסחר בבדים | Trade in fabrics | | 10144 | מסחר בבדים-בדי ריפוד | Trading in padding fabrics | | 10145 | מסחר בבדים-יבואני בדי אופנה (לביגוד) | Fabric trade-in fashion fabrics (to clothing) | | 10146 | מסחר בבדים-קמעונאים: חנויות בדים | Trade in Fabrics: Fabric Stores | | 10147 | מסחר בבדים-חנויות במרכז הארץ שממקומות במרכז העיר | Trade in shop fabrics in the center of the country that are located in the city center | | 10148 | מסחר בבדים-חנויות במרכז הארץ שממקומות ברחובות צדדיים או בסמיכות לשווקים | Trade in shop fabrics in the center of the country that are located on side streets or close proximity to markets | | 10149 | מסחר בבדים-חנויות בפריפריות (מרוחקות ממרכז הארץ) | Trade in stores in peripherals (distant from the center of the country) | | 10150 | ביטוח לאומי | Social Security | | 10151 | ביטוח מוצרי חשמל | Electrical Insurance | | 10152 | סוכני ביטוח | Insurance Agents | | 10153 | תיכנות | Play | | 10154 | תוכנות מחשבים | Computer software | | 10155 | דגים | Fish | | 10156 | מסחר קמעונאי בדגים-חנויות הממוקמות בשווקים\בערי המרכז ובפריפריה באזורים עם תחרות גדולה | Retail-in-store retail trade located in the markets / cities of the center and periphery in areas with large competition | | 10157 | מסחר קמעונאי בדגים-חנויות בעלות מוניטין הממוקמות ביישוב פריפרי, לרוב חנויות גדולות | Retail trade in reputable fish-stores located in a peripheral settlement, usually large stores | | 10158 | מסחר קמעונאי בדגים-חנויות הממוקמות בערי המרכז וקיימת חנות אחת או שתיים מסוג זה באזור | Retail-in-store retail trading located in the cities of the center and there is one or two stores of this type in the area | | 10159 | מעדני בשר | Meat delicacies | | 10160 | בשר חזיר-גידול החזירים | Pork-growing pigs | | 10161 | בשר חזיר-מסחר סיטוני בגופות חזירים וטבחות בקר (מפורקים) | Sights pork pork in pig bodies and beef (disassembled) | | 10162 | בשר חזיר-ייצור מוצרי בשר: נקניקים, מעושנים, בשרים מוכנים ובשרים מעובדים | Pork-Manufacturing Meat Products: Senannics, Smokers, Ready Meat and Processed Meats | | 10163 | אטליזים | Alas | | 10164 | בתי דפוס | Print houses | | 10165 | פירסום | Advertising | | 10166 | הוצאה לאור ספרים | Publishing Books | | 10167 | הוצאה לאור ספרים | Publishing Books | | 10168 | הוצאה לאור עיתונים | Publishing newspapers | | 10169 | בתי מרקחת | Pharmacies | | 10170 | בתי מרקחת חו"ל | Overseas pharmacies | | 10171 | בתי ספר יסודי ותיכון | Elementary and high school schools | | 10172 | גלידריות | Ice creams | | 10173 | יצרני גלידות | Ice cream manufacturers | | 10174 | גמ"ח הלוואות | Loans | | 10175 | דיסקוטק | discotheque | | 10176 | פאבים | Pubs | | 10177 | דלק לחימום ביתי | Fuel for home heating | | 10178 | התקנת מערכות סולריות | Installation of solar systems | | 10179 | דלק שרות עצמי | Fuel self -service | | 10180 | דרגאסטורים | Dargalstors | | 10181 | חנויות טבע-קבוצה 1-חנויות גדולות | Nature-Group stores 1-stores are large | | 10182 | חנויות טבע-קבוצה 2-חנויות בינוניות | Nature-Group-Group 2-Medium Stores | | 10183 | חנויות טבע-קבוצה 3-חנויות קטנות | Nature-Group stores 3-stores | | 10184 | רשתות פארמה-רשתות גדולות | Large Pharma-Networks | | 10185 | דשנים וכימיקלים | Fertilizers and chemicals | | 10186 | הובלות | Moving | | 10187 | מערבלי בטון | Concrete western | | 10188 | משאבות בטון | Concrete pumps | | 10189 | הובלת מטענים במשאיות | Transporting cargoes in trucks | | 10190 | הסעות | Shuttles | | 10191 | הסעות באוטובוסים | Buses shuttle | | 10192 | הסעות באוטובוסים ציבוריים זעירים | Shuttles on tiny public buses | | 10193 | הסעות | Shuttles | | 10194 | מוניות בקווי שירות-בין עירוני ועירוני | Taxis in Urban and Urban Service lines | | 10195 | הסעות | Shuttles | | 10196 | הסעות | Shuttles | | 10197 | מוניות בשירות מיוחד | Taxis in a special service | | 10198 | שליחיות | Curses | | 10199 | היכרויות ושדוכים | Dating and taps | | 10200 | הלבשה כללית | General dressing | | 10201 | הלוואות פקדונות חסכו | Deposit loans have saved | | 10202 | העברת כספים לכרטיס | Transfer of funds to card | | 10203 | בעלי אירוע | Event owners | | 10204 | הפקות אירועים | Productions | | 10205 | מוצרים לארועים | Products for events | | 10206 | מיזם חתונות-אולמות | Weddings Initiative | | 10207 | הרבלייף | Herbalife | | 10208 | השכרת דירות | apartments rental | | 10209 | השכרת משרדים | Office rental | | 10210 | וידאו אוטומט | Automatic video | | 10211 | וילונות ודקורטיבים | Curtains and decorative | | 10212 | חברות ניהול ואחזקה | Management and maintenance companies | | 10213 | חברות כוח אדם והשמה | Personnel companies and placement | | 10214 | ועדי בתים | And witnesses | | 10215 | עבודות עפר | Earthworks | | 10216 | עבודות עפר- עבודות קטנות היקף ובינוניות | Earthworks- small and medium-sized jobs | | 10217 | עבודות עפר ופיתוח רחבות היקף | Earthworks and wide -ranging development | | 10218 | בנייה ושיפוצים | Construction and renovations | | 10219 | מסחר מעורב בחומרי בניין | Commerce involved in building materials | | 10220 | מסחר מעורב בחומרי בניין-מסחר קמעונאי-חנות | Commerce involved in retail-shop building materials | | 10221 | מסחר מעורב בחומרי בניין-מגרש לחומרי בניין | Commerce involved in building-building materials for building materials | | 10222 | מסחר קמעונאי במוצרי פרזול | Retail trading in forging products | | 10223 | מסחר קמעונאי במוצרי פרזול-חנויות כלליות | Retail trading in General Shopping Products | | 10224 | מסחר קמעונאי במוצרי פרזול-חנויות מקצועיות: מכירה לפרטיים | Retail trade in Professional Professional Store Products: Private Sales | | 10225 | מסחר קמעונאי במוצרי פרזול-חנויות מקצועיות: מכירה לנגרים | Retail trade in Professional Professional Store Products: Sales for Density | | 10226 | מסחרי בצרכי גינון | Commercial in gardening needs | | 10227 | חברות בניה | Construction girlfriends | | 10228 | קבלני גגות | Roofing contractors | | 10229 | קבלני גגות גדולים | Large roof contractors | | 10230 | קבלני גגות קטנים | Small roofs | | 10231 | סוככים ופרגולות | Awnings and pergolas | | 10232 | סוככים ופרגולות-עסקים גדולים | Large awnings and pergolas | | 10233 | סוככים ופרגולות-עסקים קטנים | Small awnings and pergolas | | 10234 | איטום גגות | roof sealing | | 10235 | איטום גגות-2 שכבות זפת+פיברגלס או אינטרלס | Sealing Roofs 2 Tarboxs+Fiberglass or Interlis | | 10236 | איטום גגות-יריעות ביטומנית | Sealing roofs-bituminous sheets | | 10237 | איטום גגות-סיוד גגות | Sealing roof-roofs | | 10238 | קבלני שלד | Skeletal contractors | | 10239 | קבלני שלד-בניין גבוה ונמוך בשיטה הקונבנציונלית | High and low building skeletal contractors in the conventional method | | 10240 | קבלני שלד-בית צמוד קרקע בשיטה הקונבנציונלית | Land-linked skeleton contractors using the conventional method | | 10241 | קבלני משנה לאינסטלציה חשמלית | Subcontractors for electrical plumbing | | 10242 | קבלני משנה לאינסטלציה סניטרית | Subcontractors to Sanitarian plumbing | | 10243 | קבלני משנה לאינסטלציה סניטרית-קבלני אינסטלציה לבתים פרטיים | Subcontractors for Senternity-contractor plumbing for private homes | | 10244 | קבלני משנה לאינסטלציה סניטרית-קבלני אינסטלציה לבנייני מגורים נמוכים עד גבוהים | Subcontractors for Senternity-contractor plumbing plumbing for low to high residential buildings | | 10245 | קבלני משנה לאינסטלציה סניטרית-קבלני אינסטלציה לבנייני מגורים רבי קומות | Subcontractors for Senternity-contractor plumbing plumbing for high-rise residential buildings | | 10246 | מוצרי אינסטלציה | Plumbing products | | 10247 | מסחר בקרמיקה וכלים סניטריים | Ceramic trading and sanitary ware | | 10248 | מסחר בקרמיקה וכלים סניטריים-יבואנים גדולים | Trading in ceramics and a great sanitary-importer | | 10249 | מסחר בקרמיקה וכלים סניטריים-יבואנים קטנים | Trading in ceramics and small sanitary-imported tools | | 10250 | מסחר בקרמיקה וכלים סניטריים-יצרנים מקומיים ליבואנים, לקמעונאים ולקבלנים | Commerce in ceramics and sanitary-manufacturers to local importers, retailers and contractors | | 10251 | מסחר בקרמיקה וכלים סניטריים-יצרנים מקומיים לצרכן הפרטי | Ceramic trading and sanitary-manufacturers to private consumer | | 10252 | חברות עירוניות | Urban companies | | 10253 | קיבוצים | Kibbutzim | | 10254 | חברות תעופה | Airlines | | 10255 | חברת דלק מקשר | A fuel company connects | | 10256 | חברת דלק צי רכב | Delek Company Vehicle fleet | | 10257 | חברת חשמל | IEC | | 10258 | חומרי ניקוי | Cleaners | | 10259 | פרפומריות | Poptimism | | 10260 | חלקי חלוף לרכב | Parts of pass to car | | 10261 | מסחר סיטונאי בחלקי חילוף לרכב | Wholesale trading in car spare parts | | 10262 | מסחר קמעונאי בחלקי חילוף לרכב | Retail trading in car spare parts | | 10263 | חלקי חלוף לרכב | Parts of pass to car | | 10264 | חלקי חלוף לרכב | Parts of pass to car | | 10265 | טבק וצרכי עישון | Tobacco and smoking needs | | 10266 | טובין דיגיטלי | Digital goods | | 10267 | טלפונים סלולריים | cellphones | | 10268 | טפטים | Wallpapers | | 10269 | טרקלין שדה תעופה | Airport lounge | | 10270 | יהלומים/אבנים יקרות | Diamonds/Dear Stones | | 10271 | חריטת אופנים לליטוש יהלומים | Engraving bike to polishing diamonds | | 10272 | החזרי מס | Tax refunds | | 10273 | ייעוץ משכנתאות/החזרי מס | Mortgage counseling/tax refunds | | 10274 | ייעוץ פיננסי | financial advice | | 10275 | דלתות פלדה | Steel doors | | 10276 | כלי בית ומטבח | Houseware and kitchen | | 10277 | מטבחים | Kitchens | | 10278 | קבלני טיח | Plaster contractors | | 10279 | קבלני טיח-קבלן משנה לטיח בנייה רוויה, טיח גבס | Plaster-contractor contractors for saturated construction, plaster plaster | | 10280 | קבלני טיח-קבלן משנה לטיח בבנייה רוויה, טיח שחור | Plaster-contractor contractors for plaster with saturated construction, black plaster | | 10281 | קבלני טיח-קבלן טיח בבנייה פרטית | Plaster-contractor contractors with private construction | | 10282 | מקלחונים | Showers | | 10283 | קרמיקה וכלים סניטרים | Ceramic and sanitary ware | | 10284 | קבלני מצבות | Tombstones | | 10285 | הרכבת שיש במטבחים ואמבטיות | The train has in kitchens and baths | | 10286 | מפעלי הבטון | Concrete factories | | 10287 | ייצור בלוקים | Production of blocks | | 10288 | כלי מיטה | Bedding | | 10289 | מזרונים וחדרי שינה | Mattresses and bedrooms | | 10290 | כלי נגינה | Musical Instruments | | 10291 | בנין צבע | A color building | | 10292 | קבלני משנה לצבע | Subcontractors to color | | 10293 | קבלני משנה לצבע-צביעת פנים הדירה | Subcontractors to the color of the interior of the apartment | | 10294 | קבלני משנה לצבע-צביעת הבניין מבחוץ | Subcontractors to the color of the building from the outside | | 10295 | כלי עבודה | Tools | | 10296 | יבואני רכב | Car importers | | 10297 | כלי רכב | Vehicles | | 10298 | לוטו טוטו | Lotto Toto | | 10299 | ליסינג | Leasing | | 10300 | מוניות | Taxis | | 10301 | תחבורה ציבורית | Public Transport | | 10302 | מועדוני ספורט | Sports Clubs | | 10303 | מחנאות | camping | | 10304 | מועצות ועיריות | Councils and municipalities | | 10305 | מיסי עיריות/רשויות | Municipal taxes/authorities | | 10306 | מוזיאונים | Museums | | 10307 | מרכז אומניות ועבודות יד | Arts and Handmade Center | | 10308 | תאטרון תרבות ופנאי | Culture and leisure theater | | 10309 | מוצרי גומי ופלסטיק | Rubber and plastic products | | 10310 | צמיגים | Tires | | 10311 | מסחר קמעונאי ותיקון צמיגים (פנצ'ריות) | Retail trading and tire repair (punctures) | | 10312 | מסחר קמעונאי ותיקון צמיגים (פנצ'ריות)-מכירת צמיגים חדשים בכלי רכב פרטיים | Retail trade and tire repair (punctures)-Selling new tires in private vehicles | | 10313 | מסחר קמעונאי ותיקון צמיגים (פנצ'ריות)-מכירת צמיגים חדשים ברכבי משא | Retail trade and tire repair (punctures)-Selling new tires in freight vehicles | | 10314 | מסחר קמעונאי ותיקון צמיגים (פנצ'ריות)-מכירת צמיגים משומשים | Retail trade and tire repair (punctures)-Selling used tires | | 10315 | מסחר קמעונאי ותיקון צמיגים (פנצ'ריות)-תיקון תקרים | Retail trading and tire repair (punctures)-repairing ceilings | | 10316 | צמיגים | Tires | | 10317 | חברות גז | Gas companies | | 10318 | מוצרי גז | Gas products | | 10319 | אביזרי חשמל | Electrical accessories | | 10320 | מוצרי חשמל גדולים | Large electrical products | | 10321 | מוצרי חשמל גדולים-מזגנים | Large-air-conditioned electrical products | | 10322 | מוצרי חשמל גדולים-מזגנים | Large-air-conditioned electrical products | | 10323 | מזגנים-קטנים עד 1.5 כ"ס | Air conditioners up to 1.5 kW | | 10324 | מזגנים-בינוניים 2.5-3.5 כ"ס | Medium-medium-to-mediums 2.5-3.5 kW | | 10325 | מגזנים-גדולים 4 כ"ס ומעלה ומיני מרכזיים | Magazines-large 4 kW and centers and mini | | 10326 | דודי שמש ואנרגיה סולארית | Solar boilers and solar energy | | 10327 | דודי שמש ואנרגיה סולארית | Solar boilers and solar energy | | 10328 | חשמל ואלקטרוניקה | electricity and electronics | | 10329 | רדיו ומערכות למכוניות | Radio and systems for cars | | 10330 | מוסכים לחשמלאות רכב | Garages for car pumps | | 10331 | מכוני רחיצה למכוניות | Watchs for cars | | 10332 | תיקון והתקנת מוצרי חשמל | Repair and installation of electrical appliances | | 10333 | פירסום ודפוס | Advertising and pattern | | 10334 | מוצרי תוכן דיגיטלי | Digital content products | | 10335 | בתי טבע | Natural homes | | 10336 | מוצ.דיאטה | Moada diet | | 10337 | מזכרות מתנות חפצי חן | Souvenirs of grace gifts | | 10338 | אטרקציות | attractions | | 10339 | ברכות שחיה/קאנטרי קלאב | Congratulations/Country Club | | 10340 | מאמני כושר | Fitness trainers | | 10341 | ספורט ומחנאות | Sports and flattens | | 10342 | מחשבים | Computers | | 10343 | חנויות סלולר | Cellular shops | | 10344 | מטהרי מים-מכירת ציוד | Water Pure-Sale Equipment | | 10345 | מטהרי מים-שירות | Service-water purifiers | | 10346 | מכלת ומינימרקט | Intelligence and Minimarket | | 10347 | מיסטיקה | Mysticism | | 10348 | מתפרות | Sewn | | 10349 | בית חולים פרטי/מרכז שיקום/מכון רפואי | Private Hospital/Rehabilitation Center/Medical Institute | | 10350 | מכונות כתיבה/תפירה | Writing/sewing machines | | 10351 | מכונות לתעשיה חקלאות | Agricultural Industries Machines | | 10352 | חוגים וקורסים | Classes and courses | | 10353 | מכוני לימוד והדרכה | Learning and Training Institutes | | 10354 | מכללות ואוניברסיטאות | Colleges and universities | | 10355 | מכוני קוסמטיקה | Cosmetics institutes | | 10356 | יבואני אופנועים | Motorcycles importers | | 10357 | סוכנות אופנועים | Motorcycle agency | | 10358 | מוסכי קטנועים ואופנועים | Scooters and motorcycles garages | | 10359 | תיווך נדל"ן | Real Estate | | 10360 | מכירת כלי רכב | Selling vehicles | | 10361 | מכירת כלי רכב | Selling vehicles | | 10362 | מכירת מכשירי גז | Selling Gas Devices | | 10363 | מכשירי בריאות | Health devices | | 10364 | בית חב"ד | Chabad House | | 10365 | בית כנסת | Synagogue | | 10366 | סופרי סת"ם | Catholic writers | | 10367 | עמותה לרווחת חיילים | Association for the Welfare of Soldiers | | 10368 | עמותות בריאות | Health associations | | 10369 | עמותות לקהילה | Community associations | | 10370 | עמותות מחקר | Research associations | | 10371 | מנויי לוטו טוטו | Lotto Toto subscribers | | 10372 | אלומיניום מסגריות | Aluminum Fragments | | 10373 | חדר עסקאות - פורקסים | Transaction Room - Forxies | | 10374 | מסחר במט"ח | Forex Trading | | 10375 | מסעדות | Restaurants | | 10376 | מסעדות פועלים | Restaurant Works | | 10377 | מסעדות סיניות | Chinese restaurants | | 10378 | מסעדות מזרחיות | Eastern restaurants | | 10379 | מסעדות דגים | Fish restaurants | | 10380 | מסעדות איטלקיות | Italian restaurants | | 10381 | פאות | Wigs | | 10382 | טכנאות שיניים | Tooth techniques | | 10383 | מעבדת שניים | Two lab | | 10384 | מערכות אזעקה | Alarm systems | | 10385 | מערכות בטחון | Security systems | | 10386 | מפעל הפיס - זכיינים | Lottery - franchisees | | 10387 | מפעל הפיס | Lottery | | 10388 | משחקים און ליין | Games online | | 10389 | יקב | winery | | 10390 | משקאות חריפים וקלים | Acute and soft drinks | | 10391 | משרד התחבורה-רישוי | The Ministry of Transport-Licensing | | 10392 | משרדי ממשלה | Government Offices | | 10393 | משרדי פרסום | Advertising agencies | | 10394 | הדברת מזיקים | Pest control | | 10395 | מתן אשרות שהיה | Giving visas that was | | 10396 | מרכז קהילתי | community Center | | 10397 | מתנס | community Center | | 10398 | נגריות/רפדיות | Carpentry/paddies | | 10399 | בדי רפוד | Rapped Fabrics | | 10400 | מסחר בחומרי נגרות | Trading in carpentry materials | | 10401 | מסחר בחומרי נגרות-מכירות מסיביות-הפצה | Trading in massive carpentry materials-distributing | | 10402 | מסחר בחומרי נגרות-מכירה סיטונאית | Trading in carpentry-wholesale materials | | 10403 | מסחר בחומרי נגרות-מכירה קמעונאית ("לפרטיים") | Trade in retail carpentry materials (“to private”) | | 10404 | מסחר בחומרי נגרות-מכירות חומרי עץ מעובדים | Trade in carpentry materials-wooden materials processed | | 10405 | מסחר בחומרי נגרות-מכירת פרזולים וחומרים שונים | Trading in carpentry-selling materials and various materials | | 10406 | נותני שרותי מטבע (חלפני כספים) | Currency service providers (Financial Almighty) | | 10407 | הנעלה | footwear | | 10408 | הנעלה-חנויות סוג 1 | Type-Type 1 store | | 10409 | הנעלה-חנויות סוג 2 | Type 2 stores | | 10410 | הנעלה-חנויות סוג 3 | The trace-store type 3 | | 10411 | הנעלה-חנויות סוג 4 | The Type 4 stores | | 10412 | נשק ותחמושת | Weapons and ammunition | | 10413 | נשק ותחמושת | Weapons and ammunition | | 10414 | סדקית ומוצרי תפירה | Crack and sewing products | | 10415 | סוכני דלק | Fuel agents | | 10416 | מסחר בדלק | Fuel commerce | | 10417 | מסחר בדלק-תחנות של חברות הדלק היצרניות: בנזין 95 | Fuel trading of the manufacturer's fuel companies: gasoline 95 | | 10418 | מסחר בדלק-תחנות של חברות הדלק היצרניות: סולר לתחבורה | Fuel trading of the manufacturer's fuel companies: Due to Transportation | | 10419 | מסחר בדלק-תחנות של חברות הדלק היצרניות: סולר להסקה | Fuel trading of the manufacturer's fuel companies: diesel fuel | | 10420 | מסחר בדלק-תחנות של חברות הדלק היצרניות: נפט | Fuel trading of the manufacturer's fuel companies: oil | | 10421 | מסחר בדלק-תחנות מוזלות של חברות הדלק היצרניות: בנזין 95 מוזל | Fuel Trade-Discounted Fuel Companies Station | | 10422 | מסחר בדלק-תחנות מוזלות של חברות הדלק היצרניות: סולר לתחבורה מוזל | Discounted Fuel Fuel Commerce of Manufacturer Fuel Companies: Dyer For Disposable Transportation | | 10423 | מסחר בדלק-מכירה סיטונאית של בנזין 95 | Fuel trading-wholesale of petrol 95 | | 10424 | מסחר בדלק-מכירה סיטונאית של סולר לתחבורה | Fuel trading-wholesale of diesel fuel for transportation | | 10425 | מסחר בדלק-סוכנים ומפיצים קמעונאים של בנזין 95 | Fuel-agent trading and retail distributors of gasoline 95 | | 10426 | מסחר בדלק-סוכנים ומפיצים קמעונאים של סולר לתחבורה בתחנה | Fuel-agent trading and retail distributors of transport to transportation at the station | | 10427 | מסחר בדלק-סוכנים ומפיצים קמעונאים של סולר לתחבורה והסקה במיכליות | Fuel-agent trading and retail distributors of diesel and heating in tankers | | 10428 | סופרמרקטים | Supermarkets | | 10429 | סטקיות ומזנונים | Steaks and buffets | | 10430 | דוכני פלאפל | Falafel booths | | 10431 | פיצוחים | Nuts | | 10432 | סיטונאי - מוצרים לא עמידים | Wholesale - non -resistant products | | 10433 | מסחר סיטוני בפירות ובירקות | Wholesale trading in fruits and vegetables | | 10434 | סיטונאי - מוצרים לא עמידים | Wholesale - non -resistant products | | 10435 | סיטונאי - מוצרים לא עמידים: משחטות-מסחר בעופות והודים | Wholesale - non -durable products: poultry trading and Indian trading | | 10436 | סוחרי בקר וצאן | Beef and flock traders | | 10437 | סיטונאי-מוצרים עמידים | Wholesale-products resistant | | 10438 | סיטונאי-מוצרים עמידים | Wholesale-products resistant | | 10439 | מסחר בבדים | Trade in fabrics | | 10440 | סיטונאי-מוצרים עמידים | Wholesale-products resistant | | 10441 | בתי קולנוע | Theaters | | 10442 | סניטציה | Sanitation | | 10443 | ספק תוכן אינטרנט | Internet content provider | | 10444 | ספריות וידיאו | Video libraries | | 10445 | דיסקים | Discs | | 10446 | דמי חברות מועדון | Club Companion Fee | | 10447 | עמותות ואגודות | Associations and associations | | 10448 | עמותות חינוך | Education associations | | 10449 | מפלגות, בחירות | Parties, elections | | 10450 | עמותות לקהילה | Community associations | | 10451 | עמותות דת | Religious associations | | 10452 | עמותות מוסלמיות | Muslim associations | | 10453 | עמותות נוצריות | Christian associations | | 10454 | עמותות תרומות | Donations of donations | | 10455 | פירות וירקות | Fruits and Vegetables | | 10456 | מסחר קמעונאי בפירות וירקות | Retail trading in fruits and vegetables | | 10457 | מסחר קמעונאי בפירות וירקות-חנויות שכונתיות עממיות | Retail trade in fruits and vegetables-mummous neighborhood stores | | 10458 | מסחר קמעונאי בפירות וירקות-חנויות שכונתיות יוקרתיות | Retail trading in prestigious neighborhoods and vegetables | | 10459 | מסחר קמעונאי בפירות וירקות-חנויות ברחובות ראשיים בערים | Retail trading in fruits and vegetables on main streets in cities | | 10460 | בגדי עור | Leather clothes | | 10461 | מסחר קמעוני בתיקים ומזוודות-חנויות סוג 1 | Retail trading in bags and luggage-type 1 | | 10462 | מסחר קמעוני בתיקים ומזוודות-חנויות סוג 2 | Retail trading in bags and luggage-type 2 | | 10463 | מסחר קמעוני בתיקים ומזוודות-חנויות סוג 3 | Retail trading in bags and luggage-store type 3 | | 10464 | פרוות | Fur | | 10465 | פרחים ועציצים | Flowers and flower pots | | 10466 | מסחר קמעונאי בפרחים | Retail trading in flowers | | 10467 | ציוד לתינוק | Baby equipment | | 10468 | מכש.כתיבה | P.S. Writing | | 10469 | מסחר קמעוני במכשירי כתיבה | Retail trading on writing devices | | 10470 | מסחר קמעוני במכשירי כתיבה-חנויות מכשירי כתיבה וציוד משרדי שעיקר מכירותיהן לחברות ומוסדרות | Retail trading on writing devices-writing devices and office equipment whose main sales for companies and regulations | | 10471 | מסחר קמעוני במכשירי כתיבה-חנויות למכשירי כתיבה וציוד משרדי שעיקר מכירותיהן ללקוחות פרטיים | Retail trading on writing-stores for writing devices and office equipment whose main sales are private customers | | 10472 | מסחר קמעוני במכשירי כתיבה-חנויות למכשירי כתיבה (כולל מכשירי כתיבה בחנויות מעורבות) | Retail Trade on Writing Store Writing devices (including writing appliances in mixed stores) | | 10473 | ציוד משרדי | Office Supplies | | 10474 | מיכשור רפואי | Medical devices | | 10475 | צמר וסריגה | Wool and knitting | | 10476 | ציוד לגנים | Garden equipment | | 10477 | צעצועים | Toys | | 10478 | מסחר בצעצועים ומשחקים | Trade in toys and games | | 10479 | מסחר בצעצועים ומשחקים-חנויות ברמה א' | Trade in toys and Games-stores at level 1 | | 10480 | מסחר בצעצועים ומשחקים-חנויות ברמה ב' | Trade in toys and Games-Stores B | | 10481 | מסחר בצעצועים ומשחקים-חנויות ברמה ג' | Trade in toys and Games-Games Level C. | | 10482 | חנויות נוחות ופיצוציות | Convenient and explosive shops | | 10483 | קייטנה | Summer Camp | | 10484 | קייטרינג | Catering | | 10485 | קפה ותבלינים | Coffee and spices | | 10486 | מסחר קמעונאי בתבלינים, קטניות, פיצוחים ופירות יבשים | Retail trading in spices, legumes, crackers and dried fruits | | 10487 | מסחר קמעונאי בתבלינים, קטניות, פיצוחים ופירות יבשים-קניון | Retail trading in spices, legumes, crackers and dried fruits-malls | | 10488 | מסחר קמעונאי בתבלינים, קטניות, פיצוחים ופירות יבשים-רחוב ראשי | Retail trading in spices, legumes, crackers and dried fruits-main street | | 10489 | מסחר קמעונאי בתבלינים, קטניות, פיצוחים ופירות יבשים-שוק | Retail trade in spices, legumes, crackers and dried fruits-market | | 10490 | רהיטים | furniture | | 10491 | רהיטים-חנויות המוכרות מוצרים פשוטים | Furniture-stores selling simple products | | 10492 | רהיטים-חנויות המוכרות מוצרים ברמה בינונית | Furniture-stores familiar with medium-level products | | 10493 | רהיטים-חנויות המוכרות מוצרים ברמה גבוהה | Furniture-stores selling high-level products | | 10494 | רהיטים-חנויות יוקרתיות (מחיר לפריט) | Luxury store furniture (item for item) | | 10495 | חנויות ריהוט וציוד לתינוקות | Furniture and baby equipment | | 10496 | חנויות ריהוט וציוד לתינוקות-חנויות קטנות עממיות | Furniture stores and equipment for small popular stores | | 10497 | חנויות ריהוט וציוד לתינוקות-חנויות בינוניות | Furniture and Baby Equipment-Medium Stores | | 10498 | חנויות ריהוט וציוד לתינוקות-חנויות גדולות | Furniture and Big Baby-store equipment | | 10499 | חנויות ריהוט וציוד לתינוקות-חנויות רשת | Furniture stores and baby-store equipment | | 10500 | ייבוא רהיטים | Import furniture | | 10501 | ייבוא מטבחים | Import kitchens | | 10502 | ייבוא מטבחים-מטבחים פשוטים | Import Kitchens-Simple kitchens | | 10503 | ייבוא מטבחים-מטבחי יוקרה | Import kitchens-kitchens luxury | | 10504 | רהיטים-ייצור רהיטים מעץ מלא | Furniture-Manufacture of solid wood furniture | | 10505 | נגרות פלטות | Passover carpentry | | 10506 | מהנדסים | engineers | | 10507 | רו"ח | Breeze | | 10508 | רכישת ניירות ערך | Purchase securities | | 10509 | טיפולי בריאות לגוף | Health treatments to the body | | 10510 | רפואה אלטרנטיבית | Alternative Medicine | | 10511 | רשות השידור | IBA | | 10512 | רשתות מזון ארציות | Nursing food chains | | 10513 | תעשיית מזון קפוא מוכן | Frozen food industry ready | | 10514 | פרקטים | Parquets | | 10515 | קבלני ריצוף | Flooring contractors | | 10516 | שטיחים | Rugs | | 10517 | שטיחים | Rugs | | 10518 | שיווק ישיר | direct marketing | | 10519 | שירותי ייעוץ | consulting services | | 10520 | שירותי מלאכה לבית | Home Craft Services | | 10521 | שירותי רכב | Automotive Services | | 10522 | מוסכי פחחות וצביעת רכב | Bins and Car Determination | | 10523 | מוסכי פחחות וצביעת רכב-מוסך מורשה או מומחה | Tinted garages and a licensed vehicle-garage or expert | | 10524 | מוסכי פחחות וצביעת רכב-מוסך כללי | Tin Garages and General Vehicle Determination | | 10525 | שירותי רכב | Automotive Services | | 10526 | מינהל ציבורי כללי | General public administration | | 10527 | פיקוח על מתן שירותי בריאות, חינוך, תרבות ושירותים חברתיים אחרים, פרט ל | Supervision for providing health, education, culture and other social services, except | | 10528 | מינהל ציבורי לנמ"א | Public Administration for the NMA | | 10529 | ניהול ענייני החוץ | Foreign Affairs Management | | 10530 | פעילויות צבא והגנה | Army and Protection Activities | | 10531 | שמירה על הסדר הציבורי ועל ביטחון הציבור | Maintaining public order and public security | | 10532 | שירותים ממשלתיים | Government Services | | 10533 | שלטים | Signs | | 10534 | שמאים | Appraisers | | 10535 | שמאי ביטוח | Insurance Appraiser | | 10536 | בתי חולים ממשלתים | Government Hospitals | | 10537 | פסיכולוגים | Psychologists | | 10538 | רופאים | Doctors | | 10539 | שרותי אמבולנס | Ambulance services | | 10540 | מכשירי כתיבה וציוד משרדי | Writing and Office Equipment | | 10541 | תחנות דלק | gas stations | | 10542 | תיווך | Mediation | | 10543 | תיירות למרפא | Tourism to Medicine | | 10544 | תכשיטים ושעונים | Jewelry and watches | | 10545 | תכשיטים ושעונים-חנויות יוקרתיות מאוד | Very prestigious jewelry and watches | | 10546 | תכשיטים ושעונים-חנויות יוקרתיות | Luxury jewelry and watches | | 10547 | תכשיטים ושעונים-חנויות איכות טובה | Jewelry and watches-good quality stores | | 10548 | תכשיטים ושעונים-חנויות בינוניות | Jewelry jewelry and watches | | 10549 | תכשיטים ושעונים-חנויות קטנות | Jewelry jewelry and watches | | 10550 | תכשיטים ושעונים | Jewelry and watches | | 10551 | יוצקים בענף התכשיטים | Pour in the jewelry industry | | 10552 | תמרוקיות | Cosmetics | | 10553 | נופש ותיור | Vacation and tour | | 10554 | סוכני נסיעות | Travel Agents | | 10555 | כנסים | Conferences | | 10556 | תערוכות | Exhibitions | | 10557 | תקליטים | Records | | 10558 | ציוד טלפוני | Telephone equipment | | 10559 | תקשורת | communication | | 10560 | טלויזיה בכבלים | Cable TV | | 10561 | עיתונות | journalism | | 10562 | תרומות | Donations | | 10563 | אלומניום | Aluminum | | 10564 | אלומניום-ייצור והתקנה | Aluminum-production and installation | | 10565 | תריסים | Shutters | - [Individual roles](https://docs.payme.io/marketplaces-and-platforms/seller-reference/individual-seller-types): Role codes for individuals linked to a seller: 1 Owner, 2 Signatory, 4 Director, 8 Executive, 16 Back Office, 32 Charity Member, 64 Committee Member, 128 Corporate Officer. Send them as an array in seller_additional_details[].type on create-seller (required, error 160; unknown code error 24). Without additional individuals, the seller's own person is Owner and Signatory for a private individual or sole proprietorship, Back Office otherwise. # Individual roles The roles a person can hold in a seller's business. Send them in `seller_additional_details[].type` on [Create a seller](https://docs.payme.io/payments/merchants-management/post-create-seller), as an array of codes. A person can hold several roles, for example `[1, 2]` for an owner who is also a signatory. `type` is required for every additional individual: without it, the call fails with error `160`. An unknown code fails with error `24`. If you don't send additional individuals, the seller's own person is set to Owner and Signatory for a private individual or a sole proprietorship, and to Back Office otherwise. | Code | Role | | --- | --- | | `1` | Owner | | `2` | Signatory | | `4` | Director | | `8` | Executive | | `16` | Back Office | | `32` | Charity Member | | `64` | Committee Member | | `128` | Corporate Officer | - [Seller incorporation types (Israel)](https://docs.payme.io/marketplaces-and-platforms/seller-reference/seller-incorporation-types-il): Israeli incorporation type codes for seller_inc on create-seller and update-seller (0 or 1 Individual, 2 Sole Proprietorship, 3 Incorporated Company, 4 Partnership, 5 Exempt Sole Proprietorship, 6 Charity, 7 Limited Partnership, 8 Publicly Traded Company, 9 Shared Cooperative, 10 Public Benefit Company, 295 House Committee, 296 Municipalities and councils). The type must match seller_address_country, and seller_inc_code must fit the type's rule, otherwise error 114. # Seller incorporation types (Israel) Send the code as `seller_inc` on [Create a seller](https://docs.payme.io/payments/merchants-management/post-create-seller) and [Update a seller](https://docs.payme.io/payments/merchants-management/post-update-seller). The type must belong to the seller's country (`seller_address_country`, Israel by default). Otherwise the request fails with error `114`. For other countries, get the codes from `GET /business-types/{country_iso_code}`. | Code | Type in Hebrew | Type in English | | --- | --- | --- | | `1` (or `0`) | פרטי | Individual | | `2` | עוסק מורשה | Sole Proprietorship | | `3` | חברה בע"מ | Incorporated Company | | `4` | שותפות | Partnership | | `5` | עוסק פטור | Exempt Sole Proprietorship | | `6` | עמותה | Charity (non-profit) | | `7` | שותפות מוגבלת | Limited Partnership | | `8` | חברה ציבורית | Publicly Traded Company | | `9` | אגודה שיתופית | Shared Cooperative (cooperative society) | | `10` | חברה לתועלת הציבור (חל"צ) | Public Benefit Company | | `295` | ועד בית | House Committee | | `296` | עיריות ומועצות | Municipalities and councils | > **Individual is `0` in the seller API.** `seller_inc` accepts `0` or `1` for a private individual and always returns `0`. `GET /business-types/IL` returns the stored id, which is `1` for the same type. ## Business code rule The seller's business code (`seller_inc_code`) must fit its incorporation type. Otherwise the request fails with error `114`, and the error message says which rule failed. | Type | `seller_inc_code` must | | --- | --- | | `1`/`0` Individual, `2` Sole Proprietorship, `5` Exempt Sole Proprietorship | Equal the owner's national ID number (`seller_social_id`) | | `3` Incorporated Company, `8` Publicly Traded Company, `10` Public Benefit Company | Start with `51`, `52` or `56` | | `4` Partnership | Start with `53` or `55` | | `6` Charity | Start with `58` or `59` | | `7` Limited Partnership | Start with `54` | | `9` Shared Cooperative | Start with `57` | | Municipalities and councils | Start with `50` | | House Committee | Contact PayMe before you send a `seller_inc_code` | For every type except Individual, Sole Proprietorship and Exempt Sole Proprietorship, the business code must not equal the owner's national ID number. ## Documents Most types need the corporate certificate (file type `3`). A House Committee needs file types `14` (authorized signer protocol) and `7` (processing agreement) instead. Municipalities and councils need `27` (origin tax confirmation) and `7` instead. See [File types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/file-types). - [VAS types](https://docs.payme.io/marketplaces-and-platforms/seller-reference/vas-types): List of vas_type values for PayMe value-added services (VAS). The API takes and returns the type name (case-insensitive), for example AlternativePaymentMethod for Apple Pay and Google Pay; numeric codes are rejected with error 24. Used by vas-enable and get-vas-seller. # VAS types Value-added services (VAS) are identified by type. Send the type **name** as `vas_type` in VAS calls, for example `"vas_type": "AlternativePaymentMethod"`. Names are case-insensitive, and responses return the name. A number or an unknown name returns error `24`. `vas_type` is used by: - [Enable Apple Pay](https://docs.payme.io/payments/apple-pay/post-vas-enable-apple-pay) and [Enable Google Pay](https://docs.payme.io/payments/google-pay/post-vas-enable-google-pay), with `AlternativePaymentMethod`; - [List a seller's services](https://docs.payme.io/payments/merchants-management/post-get-vas-seller), to filter by type and in each returned item. | `vas_type` | | --- | | `Integration` | | `Payments` | | `Discount` | | `Merchandise` | | `Invoice` | | `Sms` | | `CreditMatch` | | `Antifraud` | | `Insurance` | | `Delivery` | | `Marketplace` | | `Development` | | `CreationPlans` | | `VaultsExternal` | | `AlternativePaymentMethod` | | `Loan` | | `MIDs` | | `MIDSwitcher` | | `ReleaseDate` | | `Settlements` | | `Email` | | `Catalog` | | `Customers` | | `MerchantRules` | | `InvoicingService` | | `KeepAdditionalService` | | `Pos` | ## Reporting - [Reporting across your sellers](https://docs.payme.io/marketplaces-and-platforms/reporting/reporting-across-your-sellers): How a partner reports across its sellers with the query APIs: send payme_client_key (body or PayMe-Partner-Key header) and optionally seller_payme_id (up to 100). Recipes for volume and refunds (get-transactions), active subscriptions (get-subscriptions), seller counts and balances (get-sellers, not api_mode slim), payouts (get-withdrawals, get-future-withdrawals), paging up to 500 per page and rate limits. ## Related - [Find the right data](https://docs.payme.io/accepting-payments/reporting/find-the-right-data) - [Withdrawals](https://docs.payme.io/marketplaces-and-platforms/fees-and-payouts/withdrawals) # Reporting across your sellers ## Two ways to get the data As a partner, you can export reports by hand from the Partner Dashboard, or pull the same kind of data with the query APIs. This guide covers the query APIs. Send your `payme_client_key` on [get-sellers](https://docs.payme.io/payments/query-apis/post-get-sellers), [get-sales](https://docs.payme.io/payments/query-apis/post-get-sales), [get-transactions](https://docs.payme.io/payments/query-apis/post-get-transactions), [get-subscriptions](https://docs.payme.io/payments/query-apis/post-get-subscriptions) and [get-withdrawals](https://docs.payme.io/payments/query-apis/post-get-withdrawals). It can go in the body or in the `PayMe-Partner-Key` header; see [Authentication](https://docs.payme.io/payments/getting-started/authentication). ## Choose the sellers | To query | Send | | --- | --- | | All your sellers | `payme_client_key` only | | One seller | `payme_client_key` and `seller_payme_id` | | Several sellers | `payme_client_key` and `seller_payme_id` as an array, up to 100 values | Send only MPLs of your own sellers. Every item in the response carries its `seller_payme_id`, so you can group results by seller. ## Seller performance Call `get-transactions` for a period. Group the items by `seller_payme_id` and add up `transaction_price` for volume, or count them for the number of payments. ```json { "payme_client_key": "XXXXXXXX", "seller_payme_id": ["MPLDEMO-MPLDEMO-MPLDEMO-1234567"], "transaction_status": "validated", "sale_currency": "ILS", "transaction_created_min": "2026-10-01 00:00:00", "transaction_created_max": "2026-10-31 23:59:59", "page_size": 500, "page": 1 } ``` Leave out `seller_payme_id` to cover all your sellers. Refunds and chargebacks are separate rows: request `transaction_status` `["refunded", "p-refund"]` or `["chargeback", "partial-chargeback"]` and subtract their `transaction_price` for net volume. Add back `["chargeback-refund", "partial-chargeback-refund"]`, which are chargebacks that were reverted. ## Average transaction value From the `get-transactions` results, divide the sum of `transaction_price` by the number of items, per seller and per currency. Amounts are in minor units. ## Active subscriptions Call `get-subscriptions` with `sub_status` `2` and group by `seller_payme_id`. Other values are on [Subscription Statuses](https://docs.payme.io/payments/codes-statuses/subscription-statuses). ```json { "payme_client_key": "XXXXXXXX", "sub_status": 2, "page_size": 500, "page": 1 } ``` Group by `sub_iteration_type` and `sub_price` to estimate recurring revenue. The types are on [Subscription Iteration Types](https://docs.payme.io/payments/codes-statuses/subscription-iteration-types). ## Number of sellers Call `get-sellers` and count the items across all pages. `items_count` covers the current page only. `get-sellers` returns seller accounts only, not partner or system accounts, so the count is your sellers. ```json { "payme_client_key": "XXXXXXXX", "seller_active": true, "page_size": 500, "page": 1 } ``` Useful filters: `seller_approved`, `seller_created_min` and `seller_created_max`. Each item also has the seller's fees in `seller_fees`, and balances in `seller_wallets`. ## Balances across sellers `get-sellers` returns each seller's `seller_wallets`, so one call can refresh many sellers. Don't send `api_mode` `slim`, which leaves out `seller_wallets`. Send `seller_payme_id` as an array of up to 100 values, instead of one call per seller. `wallet_total` is everything PayMe holds for the seller, and `wallet_releasable` is the part past its release date. ```json { "payme_client_key": "XXXXXXXX", "seller_payme_id": ["MPLDEMO-MPLDEMO-MPLDEMO-1234567"], "page_size": 500, "page": 1 } ``` ## Payouts Call `get-withdrawals` with a date range and group `withdrawal_total` by `seller_payme_id` and `withdrawal_currency`. `get-future-withdrawals` takes one seller and one currency per request, so call it once for each. ## Run large reports safely - **Pages:** `page_size` goes up to 500, which is also the default, and `page` starts at 1 and goes up to 1000. Without them, you get only the first 500 items. Keep requesting pages until `items_count` is lower than `page_size`; for larger results, narrow the dates. - **Time:** timestamps and the `*_min` / `*_max` filters are [Asia/Jerusalem local time](https://docs.payme.io/payments/query-apis#timezone). - **Rate limits:** `get-transactions` and `get-future-withdrawals` are rate limited. On HTTP 429 with code `998`, wait and retry; see [Errors](https://docs.payme.io/payments/getting-started/errors). - **Personal data:** `get-sellers` and the buyer details on sales, transactions and subscriptions include personal and bank details. Keep the partner key and the results on your server.