# Seller Onboarding

Reference pages: [Create Seller](/payments/merchants-management/post-create-seller) for the fields, [How to Create New Sellers](/marketplaces-and-platforms/seller-onboarding/create-seller) for the white-label form, [Test Cards and Payment Methods](/payments/getting-started/test-cards-and-payment-methods#creating-test-sellers-partners) for sandbox values.

## Choose the path first

| | PayMe's white-label form | `create-seller` API |
|---|---|---|
| Who builds the form | PayMe | You |
| ID and bank details pass through your servers | No | Yes |
| Availability | PayMe enables it on request | Every partner |

Ask the person which path they want. Prefer the white-label form when PayMe has enabled it. Everything after the MPL exists applies to both.

## What create-seller rejects

These are from the sandbox:

| Sent | Result |
|---|---|
| `seller_phone: "0501234567"` | Refused: [error 25](/agents/errors/error-25) |
| `seller_phone: "+972501234567"` | Accepted |
| `seller_birthdate: "1990-01-01"` | Refused: [error 116](/agents/errors/error-116). Dates are `dd/mm/yyyy` |
| `seller_inc: 2` with `seller_inc_code` different from `seller_social_id` | Refused: [error 114](/agents/errors/error-114) |
| A `seller_inc_code` that isn't numeric | Refused: [error 121](/agents/errors/error-121) |

Validate these before calling PayMe. Other rules:

- For individuals, sole proprietors and exempt dealers, `seller_inc_code` must equal `seller_social_id`.
- A plan can require or refuse a field, and [error 790](/agents/errors/error-790) names it. `seller_id` is the usual one. Correlate on `seller_payme_id`, which always works.
- Leave out `seller_plan` until your account manager gives you a value.
- `market_fee` is a plain number of percent, such as `2.5`: see [Platform Fees](/marketplaces-and-platforms/fees-and-payouts/platform-fees).

## What to store

Save the response before anything else can fail.

| Field | What to do |
|---|---|
| `seller_payme_id` | Store it. You can read it again from `get-sellers` |
| `seller_public_key.uuid` | Store it. You can read it again with [Get Seller Public Key](/payments/merchants-management/get-sellers-mpl-public-keys) |
| `seller_dashboard_signup_link` | Store it exactly as returned and show it to the seller, who finishes onboarding there. Its host depends on your partner account and may differ from the API host, so don't build it yourself |
| `seller_payme_secret` | Ignore it (SEC-06) |

## Approval gates payouts, not payments

A new partner-created seller is active and not approved. In the sandbox a sale on an unapproved seller completed.

- Never block checkout on approval.
- Show the seller its approval state and its signup link, because a seller who hasn't finished can't be paid out.

## Reading state back

[`get-sellers`](/payments/query-apis/post-get-sellers) is the source of truth for approval, fees, currencies and balances. They change without notice, so keep at most a display copy.

- A JSON array of `seller_payme_id` fetched several sellers in one call in the sandbox. Use it rather than one call per seller.
- `seller_fees.fee_market_fee` shows the fee PayMe holds for that seller.
- Seller callbacks are unsigned: see [Callbacks (Partner)](/agents/steps/callbacks-partner).