Getting Started
- Products & Customers API overview: Products & Customers is a separate PayMe service that keeps a seller's product catalogue and customer list, with its own hosts and access token. Sections: Authentication (get and refresh a token), Products and Customers (create, get, list, update, delete). Prices are decimal major units as {amount, currency}, unlike the Payments API. Read Authentication and environments, then Errors.
- Authentication and environments: Hosts: https://payme-store-staging.payme.io/api/ (sandbox), https://payme-store.payme.io/api/ (production), separate from the Payments hosts. POST /auth-tokens with {"mpl": seller MPL, "key": partner payme_client_key} returns 201 with auth_token (JWT) and refresh_token; send Authorization: Bearer <auth_token>. POST /refresh-exchanges with {"refresh_token"} (no headers) returns a new auth_token and a new single-use refresh_token. Only partners can get a token.
- Errors: Error body: status_error_details (Hebrew unless Accept-Language: en or ?lang=en), status_error_code (501 validation with HTTP 400, 999 any other error), validation_errors (field -> rule -> message), status_additional_info, session (quote to support). HTTP 400 invalid input, 401 bad or expired token, 404 not found or another seller's, 409 duplicate product_remote_id or customer_external_id, 500 server error.