2 operations. Every schema and example on this page is generated from the platform contract.
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.
The newest seller terms version this shop has agreed to, or null.
The one line to show, or null: nothing to ask (or not the owner).
The version to agree to.
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.
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.
What changed, in one plain paragraph.
Where its words can be read.
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"import { createMembberClient } from "@membber/sdk-ts";
const membber = createMembberClient({
getAccessToken: () => process.env.MEMBBER_TOKEN,
});
const { data, error } = await membber.raw.GET("/api/v1/seller-terms", {
params: { query: { store_id: "6659c139-0000-4000-8000-d0c500000066" } },
});
if (error) {
// Typed error envelope: { error: { code, message, requestId } }
throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);import MembberSwift
let client = MembberClient(
serverURL: MembberClient.productionServerURL,
tokenProvider: { session.accessToken }
)
let response = try await client.api.getSellerTermsStatus(
query: .init(storeId: "6659c139-0000-4000-8000-d0c500000066")
).ok.body.json
print(response){
"agreed_version": -9007199254740991,
"ask": {
"version": -9007199254740991,
"coming": true,
"starts_at": "<starts_at>",
"summary": "<summary>",
"read_url": "https://example.com/image.jpg"
},
"leaving": true
}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).
The version she agreed to: the one `ask` named.
Where she tapped Agree.
seller_webbusiness_appThe version now on record as agreed.
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"
}'import { createMembberClient } from "@membber/sdk-ts";
const membber = createMembberClient({
getAccessToken: () => process.env.MEMBBER_TOKEN,
});
const { data, error } = await membber.raw.POST("/api/v1/seller-terms/agree", {
body: {
store_id: "6659c139-0000-4000-8000-d0c500000066",
version: 1,
from: "seller_web"
},
headers: { "Idempotency-Key": crypto.randomUUID() },
});
if (error) {
// Typed error envelope: { error: { code, message, requestId } }
throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);import MembberSwift
let client = MembberClient(
serverURL: MembberClient.productionServerURL,
tokenProvider: { session.accessToken }
)
let response = try await client.api.agreeSellerTerms(
body: .json(.init(
storeId: "6659c139-0000-4000-8000-d0c500000066",
version: 1,
from: .sellerWeb
))
).ok.body.json
print(response){
"agreed_version": -9007199254740991,
"already": true
}