API referenceSeller terms

Seller terms

2 operations. Every schema and example on this page is generated from the platform contract.

Whether this shop has new seller terms to agree to.

Reads only. For the signed-in owner; anyone else gets ask null. The Drops seller web and the Business app show one line with Agree while ask is set.

Parameters

store_idstring · uuidqueryrequired

Response, 200

agreed_versioninteger, nullablerequired

The newest seller terms version this shop has agreed to, or null.

askobjectrequired

The one line to show, or null: nothing to ask (or not the owner).

5 child fields
versionintegerrequired

The version to agree to.

comingbooleanrequired

True while it has not started for THIS shop (her notice date is ahead, or she has no notice yet): agreeing now makes it apply to her shop now.

starts_atstring, nullablerequired

When it starts for this shop (ISO): her notice date. Null when it already applies to her, or she has not been sent its notice.

summarystringrequired

What changed, in one plain paragraph.

read_urlstringrequired

Where its words can be read.

leavingbooleanrequired

She asked to close her shop rather than take the new terms.

curl -G "https://www.membber.com/api/v1/seller-terms" \
  -H "Authorization: Bearer $MEMBBER_TOKEN" \
  --data-urlencode "store_id=6659c139-0000-4000-8000-d0c500000066"
Response, 200
{
  "agreed_version": -9007199254740991,
  "ask": {
    "version": -9007199254740991,
    "coming": true,
    "starts_at": "<starts_at>",
    "summary": "<summary>",
    "read_url": "https://example.com/image.jpg"
  },
  "leaving": true
}

The shop owner agrees to a seller terms version.

Owner only; staff and API keys are refused. Only a published version she has not agreed to. Agreeing twice is not an error. Agreeing to a coming version makes it apply to her shop at once (she waives the rest of the notice).

Request body

store_idstring · uuidrequired
versionintegerrequired

The version she agreed to: the one `ask` named.

fromenumrequired

Where she tapped Agree.

seller_webbusiness_app

Response, 200

agreed_versionintegerrequired

The version now on record as agreed.

alreadybooleanrequired

True when it was already on record; nothing new was written.

curl -X POST "https://www.membber.com/api/v1/seller-terms/agree" \
  -H "Authorization: Bearer $MEMBBER_TOKEN" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "store_id": "6659c139-0000-4000-8000-d0c500000066",
    "version": 1,
    "from": "seller_web"
  }'
Response, 200
{
  "agreed_version": -9007199254740991,
  "already": true
}
WhatsApp
Book a Call
Get Started
Seller terms API | Membber Developers