Seller Onboarding

Reference pages: Create Seller for the fields, How to Create New Sellers for the white-label form, Test Cards and Payment Methods 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.

These are from the sandbox:

Sent	Result
`seller_phone: "0501234567"`	Refused: error 25
`seller_phone: "+972501234567"`	Accepted
`seller_birthdate: "1990-01-01"`	Refused: error 116. Dates are `dd/mm/yyyy`
`seller_inc: 2` with `seller_inc_code` different from `seller_social_id`	Refused: error 114
A `seller_inc_code` that isn't numeric	Refused: 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 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.

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
`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)

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.

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