{ "item": [ { "name": "Introspection", "description": "Token and environment introspection — your integration smoke test.", "item": [ { "id": "d5f3cc82-ba9e-4e39-9644-e870bededb1f", "name": "Token introspection", "request": { "name": "Token introspection", "description": { "content": "Returns the calling token, its supplier, the environment, and the effective\nrate-limit numbers (reflecting any granted raises). Works with any valid token\nregardless of scope. Suspended suppliers get `403` / `supplier_suspended` on\neverything **except** this endpoint. Use this as your integration smoke test.\n", "type": "text/plain" }, "url": { "path": [ "whoami" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "6645783c-0e97-4b09-b1f1-cb10b72cf27c", "name": "The calling token and supplier.", "originalRequest": { "url": { "path": [ "whoami" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"token\": {\n \"id\": \"01JZV9AB2CD4EF6GH8JK0MN2PQ\",\n \"name\": \"repricer-bot\",\n \"mode\": \"live\",\n \"scopes\": [\n \"offers:read\",\n \"offers:write\",\n \"pricing:read\"\n ],\n \"created_at\": \"2026-06-02T09:14:00Z\",\n \"last_used_at\": \"2026-07-11T13:59:41Z\"\n },\n \"supplier\": {\n \"id\": \"01JZV8K2E4Q6S8A0C2E4G6J8KM\",\n \"name\": \"Keyforge Ltd\",\n \"status\": \"active\"\n },\n \"environment\": \"production\",\n \"rate_limits\": {\n \"reads\": 600,\n \"writes\": 120,\n \"sync\": 300,\n \"bulk\": 12,\n \"simulate\": 120,\n \"test\": 6,\n \"ceilings\": {\n \"per_supplier\": 1200\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e721267e-737f-4347-b0a1-d1851a1f88b3", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "whoami" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a94b4b1-8eed-4d83-8eb0-1e28a67328d7", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "whoami" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee797d1a-f128-4518-a4b2-18b5f0b95521", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "whoami" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Catalog", "description": "Platform-owned canonical products and categories. Suppliers attach offers to canonical products — never free-text listings. New products are requested through the portal.", "item": [ { "id": "65387f84-8638-4d27-aaf2-4ef68e21e5f7", "name": "Browse/search the canonical catalog", "request": { "name": "Browse/search the canonical catalog", "description": { "content": "Paginated catalog listing with filters. `market` on each product is supplier-facing\nmarket intelligence: the currently routed buyer price, count of competing active\noffers, and whether your offer currently wins routing. No competitor identities are\nexposed. Use `updated_since` for delta sync of catalog mirrors.\n", "type": "text/plain" }, "url": { "path": [ "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Full-text search on name.", "type": "text/plain" }, "key": "q", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of game_key,gift_card,topup)", "type": "text/plain" }, "key": "type", "value": "topup" }, { "disabled": false, "description": { "content": " (This can only be one of steam,epic,gog,ea_app,ubisoft_connect,battle_net,rockstar,microsoft_store,xbox,psn,nintendo_eshop,mobile,other)", "type": "text/plain" }, "key": "platform", "value": "battle_net" }, { "disabled": false, "description": { "content": " (This can only be one of global,europe,north_america,latin_america,asia,middle_east,oceania,row,country_locked)", "type": "text/plain" }, "key": "region", "value": "north_america" }, { "disabled": false, "description": { "content": "Category subtree filter (includes descendants).", "type": "text/plain" }, "key": "category_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Only products accepting new offers.", "type": "text/plain" }, "key": "sellable", "value": "true" }, { "disabled": false, "description": { "content": "Delta sync — products updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "ce38b6cf-395a-499f-bd0b-5ccced40d4b5", "name": "A page of products.", "originalRequest": { "url": { "path": [ "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Full-text search on name.", "type": "text/plain" }, "key": "q", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of game_key,gift_card,topup)", "type": "text/plain" }, "key": "type", "value": "topup" }, { "disabled": false, "description": { "content": " (This can only be one of steam,epic,gog,ea_app,ubisoft_connect,battle_net,rockstar,microsoft_store,xbox,psn,nintendo_eshop,mobile,other)", "type": "text/plain" }, "key": "platform", "value": "battle_net" }, { "disabled": false, "description": { "content": " (This can only be one of global,europe,north_america,latin_america,asia,middle_east,oceania,row,country_locked)", "type": "text/plain" }, "key": "region", "value": "north_america" }, { "disabled": false, "description": { "content": "Category subtree filter (includes descendants).", "type": "text/plain" }, "key": "category_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Only products accepting new offers.", "type": "text/plain" }, "key": "sellable", "value": "true" }, { "disabled": false, "description": { "content": "Delta sync — products updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"slug\": \"starforge-odyssey-pc-steam-key-global\",\n \"name\": \"Starforge Odyssey (PC) — Steam Key — GLOBAL\",\n \"type\": \"game_key\",\n \"platform\": \"steam\",\n \"region\": \"global\",\n \"allowed_countries\": null,\n \"blocked_countries\": [\n \"DE\"\n ],\n \"category_id\": \"01JZT2A1B2C3D4E5F6G7H8J9K0\",\n \"attributes\": {\n \"steam_app_id\": \"1289310\",\n \"edition\": \"standard\",\n \"works_on\": [\n \"windows\"\n ]\n },\n \"form_fields\": [],\n \"status\": \"sellable\",\n \"market\": {\n \"buyer_price\": {\n \"amount\": 2049,\n \"currency\": \"EUR\"\n },\n \"active_offers\": 3,\n \"your_offer_selected\": false\n },\n \"created_at\": \"2026-03-01T10:00:00Z\",\n \"updated_at\": \"2026-07-01T08:30:00Z\"\n }\n ],\n \"next_cursor\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df698436-bdf5-4571-8e2e-7865d6532fd1", "name": "`invalid_json`, `invalid_cursor`, or `idempotency_key_invalid`.", "originalRequest": { "url": { "path": [ "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Full-text search on name.", "type": "text/plain" }, "key": "q", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of game_key,gift_card,topup)", "type": "text/plain" }, "key": "type", "value": "topup" }, { "disabled": false, "description": { "content": " (This can only be one of steam,epic,gog,ea_app,ubisoft_connect,battle_net,rockstar,microsoft_store,xbox,psn,nintendo_eshop,mobile,other)", "type": "text/plain" }, "key": "platform", "value": "battle_net" }, { "disabled": false, "description": { "content": " (This can only be one of global,europe,north_america,latin_america,asia,middle_east,oceania,row,country_locked)", "type": "text/plain" }, "key": "region", "value": "north_america" }, { "disabled": false, "description": { "content": "Category subtree filter (includes descendants).", "type": "text/plain" }, "key": "category_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Only products accepting new offers.", "type": "text/plain" }, "key": "sellable", "value": "true" }, { "disabled": false, "description": { "content": "Delta sync — products updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#invalid_cursor\",\n \"title\": \"Invalid cursor\",\n \"status\": 400,\n \"detail\": \"This pagination cursor is unknown or has expired; restart without a cursor.\",\n \"code\": \"invalid_cursor\",\n \"trace_id\": \"req_1a2b3c4d5e6f7081\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "832600d1-9cb9-42c0-8fc0-e5d4bbb18239", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Full-text search on name.", "type": "text/plain" }, "key": "q", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of game_key,gift_card,topup)", "type": "text/plain" }, "key": "type", "value": "topup" }, { "disabled": false, "description": { "content": " (This can only be one of steam,epic,gog,ea_app,ubisoft_connect,battle_net,rockstar,microsoft_store,xbox,psn,nintendo_eshop,mobile,other)", "type": "text/plain" }, "key": "platform", "value": "battle_net" }, { "disabled": false, "description": { "content": " (This can only be one of global,europe,north_america,latin_america,asia,middle_east,oceania,row,country_locked)", "type": "text/plain" }, "key": "region", "value": "north_america" }, { "disabled": false, "description": { "content": "Category subtree filter (includes descendants).", "type": "text/plain" }, "key": "category_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Only products accepting new offers.", "type": "text/plain" }, "key": "sellable", "value": "true" }, { "disabled": false, "description": { "content": "Delta sync — products updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "214aad4a-366b-4bdc-944f-105ac89761dd", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Full-text search on name.", "type": "text/plain" }, "key": "q", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of game_key,gift_card,topup)", "type": "text/plain" }, "key": "type", "value": "topup" }, { "disabled": false, "description": { "content": " (This can only be one of steam,epic,gog,ea_app,ubisoft_connect,battle_net,rockstar,microsoft_store,xbox,psn,nintendo_eshop,mobile,other)", "type": "text/plain" }, "key": "platform", "value": "battle_net" }, { "disabled": false, "description": { "content": " (This can only be one of global,europe,north_america,latin_america,asia,middle_east,oceania,row,country_locked)", "type": "text/plain" }, "key": "region", "value": "north_america" }, { "disabled": false, "description": { "content": "Category subtree filter (includes descendants).", "type": "text/plain" }, "key": "category_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Only products accepting new offers.", "type": "text/plain" }, "key": "sellable", "value": "true" }, { "disabled": false, "description": { "content": "Delta sync — products updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6fa23690-6947-4685-8805-56ffce43cee9", "name": "`validation_failed` — field-level validation; the `errors` map contains field → messages.", "originalRequest": { "url": { "path": [ "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Full-text search on name.", "type": "text/plain" }, "key": "q", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of game_key,gift_card,topup)", "type": "text/plain" }, "key": "type", "value": "topup" }, { "disabled": false, "description": { "content": " (This can only be one of steam,epic,gog,ea_app,ubisoft_connect,battle_net,rockstar,microsoft_store,xbox,psn,nintendo_eshop,mobile,other)", "type": "text/plain" }, "key": "platform", "value": "battle_net" }, { "disabled": false, "description": { "content": " (This can only be one of global,europe,north_america,latin_america,asia,middle_east,oceania,row,country_locked)", "type": "text/plain" }, "key": "region", "value": "north_america" }, { "disabled": false, "description": { "content": "Category subtree filter (includes descendants).", "type": "text/plain" }, "key": "category_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Only products accepting new offers.", "type": "text/plain" }, "key": "sellable", "value": "true" }, { "disabled": false, "description": { "content": "Delta sync — products updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#validation_failed\",\n \"title\": \"Validation failed\",\n \"status\": 422,\n \"detail\": \"price.amount must be a positive integer.\",\n \"code\": \"validation_failed\",\n \"errors\": {\n \"price.amount\": [\n \"must be a positive integer\"\n ]\n },\n \"trace_id\": \"req_9f3b2c61a8d44e0f\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "684d8203-a02b-408a-bc52-568cbc3a32d7", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Full-text search on name.", "type": "text/plain" }, "key": "q", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of game_key,gift_card,topup)", "type": "text/plain" }, "key": "type", "value": "topup" }, { "disabled": false, "description": { "content": " (This can only be one of steam,epic,gog,ea_app,ubisoft_connect,battle_net,rockstar,microsoft_store,xbox,psn,nintendo_eshop,mobile,other)", "type": "text/plain" }, "key": "platform", "value": "battle_net" }, { "disabled": false, "description": { "content": " (This can only be one of global,europe,north_america,latin_america,asia,middle_east,oceania,row,country_locked)", "type": "text/plain" }, "key": "region", "value": "north_america" }, { "disabled": false, "description": { "content": "Category subtree filter (includes descendants).", "type": "text/plain" }, "key": "category_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Only products accepting new offers.", "type": "text/plain" }, "key": "sellable", "value": "true" }, { "disabled": false, "description": { "content": "Delta sync — products updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f5d1ca07-a413-4c4d-82f5-99efc3f0702a", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Full-text search on name.", "type": "text/plain" }, "key": "q", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of game_key,gift_card,topup)", "type": "text/plain" }, "key": "type", "value": "topup" }, { "disabled": false, "description": { "content": " (This can only be one of steam,epic,gog,ea_app,ubisoft_connect,battle_net,rockstar,microsoft_store,xbox,psn,nintendo_eshop,mobile,other)", "type": "text/plain" }, "key": "platform", "value": "battle_net" }, { "disabled": false, "description": { "content": " (This can only be one of global,europe,north_america,latin_america,asia,middle_east,oceania,row,country_locked)", "type": "text/plain" }, "key": "region", "value": "north_america" }, { "disabled": false, "description": { "content": "Category subtree filter (includes descendants).", "type": "text/plain" }, "key": "category_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Only products accepting new offers.", "type": "text/plain" }, "key": "sellable", "value": "true" }, { "disabled": false, "description": { "content": "Delta sync — products updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5549fabb-4126-4544-b25c-e5770600061e", "name": "Product detail", "request": { "name": "Product detail", "description": { "content": "Single product, same shape as the list. For `type: topup` products, `form_fields`\ndeclares the buyer inputs the top-up contract will send you. The platform validates\nbuyer input against `required`/`pattern`/`max_length`/`options` **before** calling\nyour top-up validate endpoint; you receive values keyed by `key`.\n", "type": "text/plain" }, "url": { "path": [ "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "product_id", "disabled": false, "description": { "content": "(Required) Product ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "0a1c165e-56b6-4e7e-b57f-f6c79b3de82f", "name": "The product.", "originalRequest": { "url": { "path": [ "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Product ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "product_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"id\": \"01JZT5B7XCDE2FGH4JK6MN8PQ2\",\n \"slug\": \"mmo-kick-gold-1000-top-up\",\n \"name\": \"MMO Kick Gold — 1,000 Gold (top-up)\",\n \"type\": \"topup\",\n \"platform\": \"other\",\n \"region\": \"global\",\n \"allowed_countries\": null,\n \"blocked_countries\": null,\n \"category_id\": \"01JZT2A1B2C3D4E5F6G7H8J9K0\",\n \"attributes\": {\n \"game\": \"mmo-kick\",\n \"denomination\": \"1000\"\n },\n \"form_fields\": [\n {\n \"key\": \"user_id\",\n \"label\": \"Player ID\",\n \"type\": \"text\",\n \"required\": true,\n \"pattern\": \"^[0-9]{6,12}$\",\n \"max_length\": 12,\n \"help_text\": \"Settings → Profile → Player ID.\",\n \"options\": null\n },\n {\n \"key\": \"server_id\",\n \"label\": \"Server\",\n \"type\": \"select\",\n \"required\": true,\n \"pattern\": null,\n \"max_length\": null,\n \"help_text\": null,\n \"options\": [\n {\n \"value\": \"2001\",\n \"label\": \"EU West\"\n },\n {\n \"value\": \"2002\",\n \"label\": \"EU East\"\n }\n ]\n }\n ],\n \"status\": \"sellable\",\n \"market\": {\n \"buyer_price\": null,\n \"active_offers\": 0,\n \"your_offer_selected\": false\n },\n \"created_at\": \"2026-05-10T12:00:00Z\",\n \"updated_at\": \"2026-05-10T12:00:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0fb2e8c-145a-4fd1-8333-bb4f95be4327", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Product ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "product_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cb819d22-b228-4cce-bede-bd5d822edc4a", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Product ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "product_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "27be2563-8451-4079-a4a5-f8a6b257eb51", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Product ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "product_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f144742-def3-4b06-b1c2-2cbad69d86f9", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Product ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "product_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd871661-dd61-458e-8e98-97f4da993f89", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Product ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "product_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dea437fd-9d83-4687-8483-247f60bc0167", "name": "Category tree", "request": { "name": "Category tree", "description": { "content": "Flat paginated list with adjacency (`parent_id`); rebuild the tree client-side.", "type": "text/plain" }, "url": { "path": [ "categories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "92cf1390-8c28-4c61-97e4-7b614e547064", "name": "A page of categories.", "originalRequest": { "url": { "path": [ "categories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"01JZT2A1B2C3D4E5F6G7H8J9K0\",\n \"name\": \"Games\",\n \"slug\": \"games\",\n \"parent_id\": null\n },\n {\n \"id\": \"01JZT2A2P4R6T8V0X2Z4B6D8F0\",\n \"name\": \"Gift Cards\",\n \"slug\": \"gift-cards\",\n \"parent_id\": null\n }\n ],\n \"next_cursor\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55ebff0a-8f24-4694-a355-b2504e68b42d", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "categories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4ab9c9c5-450b-44a4-8782-1164280eab38", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "categories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cb9893af-dd69-4582-a178-b870adacb83a", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "categories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbb58be0-b6d9-4a61-881d-4cf32821fc14", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "categories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Pricing", "description": "Machine-readable fee schedule and pricing simulation.", "item": [ { "id": "147290ea-2f4e-4c64-a6a1-ec0af5c10453", "name": "Machine-readable fee schedule", "request": { "name": "Machine-readable fee schedule", "description": { "content": "One commission, no micro-fees. v1 numbers: commission 8.5% (850 bps) per order item\non gross sale price (rounded half-up), minimum fee €0.05 per item; **no** listing,\nprice-change, payment, or unfulfilled-sale fees. Funds settle (pending → available)\n7 days after delivery. Fee changes ship with ≥30 days notice via changelog + email;\n`effective_from` dates every revision.\n", "type": "text/plain" }, "url": { "path": [ "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "aa1a289e-1041-47ad-acaa-82b28df47e81", "name": "The current fee schedule.", "originalRequest": { "url": { "path": [ "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"version\": \"2026-07-01\",\n \"effective_from\": \"2026-07-01T00:00:00Z\",\n \"currency\": \"EUR\",\n \"commission\": {\n \"rate_bps\": 850,\n \"min_fee\": {\n \"amount\": 5,\n \"currency\": \"EUR\"\n },\n \"applies\": \"per order item, on gross sale price, rounded half-up\"\n },\n \"listing_fee\": null,\n \"price_change_fee\": null,\n \"payment_fees_charged_to_supplier\": false,\n \"payment_fees_charged_to_buyer\": false,\n \"settlement\": {\n \"holding_period_days\": 7,\n \"trigger\": \"delivery\"\n },\n \"payout\": {\n \"methods\": [\n \"sepa_bank_transfer\",\n \"paypal\"\n ],\n \"minimum\": {\n \"amount\": 2000,\n \"currency\": \"EUR\"\n },\n \"fee\": null\n },\n \"unfulfilled_sale_fee\": null,\n \"docs_url\": \"https://pay.mmokick.com/developers/fees\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "abf8c4f2-6d37-4323-b32d-cb0c1bae7418", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd4f84ca-f817-4a49-9d50-ea9ac97cef92", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6702ceaf-8488-44e3-86ee-7ffb1b6ddba7", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c35452cb-d4dd-4436-9c44-75225ef66e3e", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3d3e8771-cacd-4619-8bb7-5a40af846e93", "name": "Simulate fees, net payout, and routing outcome for a candidate price", "request": { "name": "Simulate fees, net payout, and routing outcome for a candidate price", "description": { "content": "Given a product and **either** a candidate `price` **or** a `target_net_payout`\n(both → `422` / `validation_failed`), returns exact fees, net payout, and whether\nyou'd win routing. Reverse mode computes the smallest price whose net ≥ target.\n`buyer_price` always equals `price`: buyers pay all-in, our margin **is** the\ncommission. `would_win_routing` assumes your offer is active and healthy and applies\nthe routing rule (cheapest; tie-break delivery SLA then supplier age).\n\nRead-only and safe to hammer (120/min). `Idempotency-Key` is accepted but ignored.\nCommission math: `max(round_half_up(gross × 0.085), 5)` per item.\n", "type": "text/plain" }, "url": { "path": [ "pricing", "simulate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "7176b1b0-23b2-445a-b4ba-2d473be8fc7c", "name": "Simulation result.", "originalRequest": { "url": { "path": [ "pricing", "simulate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"buyer_price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"commission\": {\n \"rate_bps\": 850,\n \"amount\": {\n \"amount\": 170,\n \"currency\": \"EUR\"\n },\n \"min_fee_applied\": false\n },\n \"net_payout\": {\n \"amount\": 1829,\n \"currency\": \"EUR\"\n },\n \"settlement\": {\n \"holding_period_days\": 7\n },\n \"market\": {\n \"current_buyer_price\": {\n \"amount\": 2049,\n \"currency\": \"EUR\"\n },\n \"would_win_routing\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ecbdf21d-af9f-475f-a5dc-6cca1b01d961", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "pricing", "simulate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "803e5aee-9000-44fe-b0a7-9fd8a5382553", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "pricing", "simulate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "43f2abb1-ab8e-46a0-a112-dad762c41f1b", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "pricing", "simulate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6efa374c-439a-41ef-8c1d-cf657bf62201", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "pricing", "simulate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35c5cf0f-78e6-46ff-b202-4edfffc2bdfd", "name": "`validation_failed` — field-level validation; the `errors` map contains field → messages.", "originalRequest": { "url": { "path": [ "pricing", "simulate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#validation_failed\",\n \"title\": \"Validation failed\",\n \"status\": 422,\n \"detail\": \"price.amount must be a positive integer.\",\n \"code\": \"validation_failed\",\n \"errors\": {\n \"price.amount\": [\n \"must be a positive integer\"\n ]\n },\n \"trace_id\": \"req_9f3b2c61a8d44e0f\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "064f8e03-618c-4d2a-b5a2-e06157b9321d", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "pricing", "simulate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "090c4808-314a-4714-b93a-a163e0231dd1", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "pricing", "simulate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Offers", "description": "Your offers on canonical products — one offer per (supplier, product). Price, stock mode, fulfilment config, health.", "item": [ { "id": "57f977f0-2a4c-43c1-bde3-ecd8b519718a", "name": "List your offers", "request": { "name": "List your offers", "description": { "content": "Paginated list of all offers belonging to the calling supplier. Filters are\noptional and combinable: `external_ref` (your ERP key — exact match), `status`,\n`product_id`, and `updated_since` for delta sync of offer mirrors.\n", "type": "text/plain" }, "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact match on your ERP key (`external_ref`).", "type": "text/plain" }, "key": "external_ref", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of draft,active,paused,paused_by_admin,archived)", "type": "text/plain" }, "key": "status", "value": "active" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Delta sync — offers updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "9dca8bf0-1b31-4f8a-a86d-ca53642cc59b", "name": "A page of offers.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact match on your ERP key (`external_ref`).", "type": "text/plain" }, "key": "external_ref", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of draft,active,paused,paused_by_admin,archived)", "type": "text/plain" }, "key": "status", "value": "active" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Delta sync — offers updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"status\": \"active\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"delivery_time\": \"instant\",\n \"low_stock_threshold\": 10,\n \"stock\": {\n \"mode\": \"declared\",\n \"declared\": 250,\n \"available\": null,\n \"reserved\": null,\n \"delivered\": 8811\n },\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\",\n \"secret_set\": true,\n \"last_healthcheck_at\": \"2026-07-11T13:55:00Z\",\n \"last_healthcheck_ok\": true\n },\n \"health\": {\n \"score\": 96,\n \"routing_eligible\": true,\n \"cooldown_until\": null\n },\n \"created_at\": \"2026-06-05T11:20:00Z\",\n \"updated_at\": \"2026-07-11T13:58:12Z\"\n }\n ],\n \"next_cursor\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4980eb85-87f2-467d-8a41-95313125d33a", "name": "`invalid_json`, `invalid_cursor`, or `idempotency_key_invalid`.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact match on your ERP key (`external_ref`).", "type": "text/plain" }, "key": "external_ref", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of draft,active,paused,paused_by_admin,archived)", "type": "text/plain" }, "key": "status", "value": "active" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Delta sync — offers updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#invalid_cursor\",\n \"title\": \"Invalid cursor\",\n \"status\": 400,\n \"detail\": \"This pagination cursor is unknown or has expired; restart without a cursor.\",\n \"code\": \"invalid_cursor\",\n \"trace_id\": \"req_1a2b3c4d5e6f7081\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "608b8d57-f1a9-4cec-8cef-37be6e51f6be", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact match on your ERP key (`external_ref`).", "type": "text/plain" }, "key": "external_ref", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of draft,active,paused,paused_by_admin,archived)", "type": "text/plain" }, "key": "status", "value": "active" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Delta sync — offers updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b554c44-1260-4e08-af78-92aefc234a45", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact match on your ERP key (`external_ref`).", "type": "text/plain" }, "key": "external_ref", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of draft,active,paused,paused_by_admin,archived)", "type": "text/plain" }, "key": "status", "value": "active" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Delta sync — offers updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fb3c762-993e-4c09-82c7-8dbcaa5e884b", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact match on your ERP key (`external_ref`).", "type": "text/plain" }, "key": "external_ref", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of draft,active,paused,paused_by_admin,archived)", "type": "text/plain" }, "key": "status", "value": "active" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Delta sync — offers updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94e30478-2f21-4496-af70-0a9312cd7939", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact match on your ERP key (`external_ref`).", "type": "text/plain" }, "key": "external_ref", "value": "string" }, { "disabled": false, "description": { "content": " (This can only be one of draft,active,paused,paused_by_admin,archived)", "type": "text/plain" }, "key": "status", "value": "active" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Delta sync — offers updated at/after this instant.", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3baec432-fd0c-424e-b55d-2c5b05765e33", "name": "Create an offer", "request": { "name": "Create an offer", "description": { "content": "One offer per (supplier, product) — duplicates return `409` / `offer_exists`.\nOffers are created in `status: draft`; activate explicitly.\n\nRules: `price.amount` ≥ 10 (minimum sale €0.10) and ≤ 50,000,000. `external_ref`\n≤ 64 chars, unique per supplier, echoed on every callback and webhook.\n`fulfilment.base_url` must be HTTPS, publicly resolvable, not a private/link-local\nIP, ≤ 2,048 chars. `stock_mode` is fixed at creation — to switch modes, archive and\nrecreate. For `uploaded` offers omit `fulfilment`/`declared_stock` (present → `422`).\n`fulfilment` is required for `declared` offers and for offers on `topup` products.\n\nThe `201` response includes — **once only** — the fulfilment signing secret\n(`fulfilment.secret`, prefix `cksec_`). Store it; it is never returned again\n(rotate to obtain a new one).\n", "type": "text/plain" }, "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"low_stock_threshold\": 10,\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\"\n },\n \"declared_stock\": 250\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "9b16b87a-fb7d-4832-8113-180c7d2d7ee0", "name": "Offer created (status draft). For declared/top-up offers the body carries the fulfilment signing secret — the only time it is shown.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"low_stock_threshold\": 10,\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\"\n },\n \"declared_stock\": 250\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"status\": \"draft\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"delivery_time\": \"instant\",\n \"low_stock_threshold\": 10,\n \"stock\": {\n \"mode\": \"declared\",\n \"declared\": 250,\n \"available\": null,\n \"reserved\": null,\n \"delivered\": 0\n },\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\",\n \"secret\": \"cksec_7f2e9a41c1f3b6a4d1e8c05b3a5e7096\",\n \"secret_set\": true,\n \"last_healthcheck_at\": null,\n \"last_healthcheck_ok\": null\n },\n \"health\": {\n \"score\": 100,\n \"routing_eligible\": false,\n \"cooldown_until\": null\n },\n \"created_at\": \"2026-06-05T11:20:00Z\",\n \"updated_at\": \"2026-06-05T11:20:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2f21a8b-a1db-4070-b2af-2819c6999fda", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"low_stock_threshold\": 10,\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\"\n },\n \"declared_stock\": 250\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f97eee58-de74-46d0-b8b2-eea07e1706a9", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"low_stock_threshold\": 10,\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\"\n },\n \"declared_stock\": 250\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b63ff70-7d07-4688-981e-9faa0c6a6981", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"low_stock_threshold\": 10,\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\"\n },\n \"declared_stock\": 250\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0276d5fe-7a91-47d1-8924-c7f875a9bea3", "name": "`offer_exists` (one offer per product — PATCH the existing offer), or an idempotency conflict.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"low_stock_threshold\": 10,\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\"\n },\n \"declared_stock\": 250\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#offer_exists\",\n \"title\": \"Offer already exists\",\n \"status\": 409,\n \"detail\": \"You already have an offer on this product. PATCH the existing offer instead.\",\n \"code\": \"offer_exists\",\n \"trace_id\": \"req_2b1c9d40e7f84a21\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fedd2c76-075a-4ff3-b0c5-1feb05fffabe", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"low_stock_threshold\": 10,\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\"\n },\n \"declared_stock\": 250\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2dfd1ead-b814-4e75-8aed-33051bd8e885", "name": "`validation_failed` or `product_not_sellable`.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"low_stock_threshold\": 10,\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\"\n },\n \"declared_stock\": 250\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#validation_failed\",\n \"title\": \"Validation failed\",\n \"status\": 422,\n \"detail\": \"price.amount must be a positive integer.\",\n \"code\": \"validation_failed\",\n \"errors\": {\n \"price.amount\": [\n \"must be a positive integer\"\n ]\n },\n \"trace_id\": \"req_9f3b2c61a8d44e0f\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f7d6b764-00dd-43de-84f9-fa718a497ccb", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"low_stock_threshold\": 10,\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\"\n },\n \"declared_stock\": 250\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b436f974-1aa5-4cb6-bd4f-abc35adafcfe", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"low_stock_threshold\": 10,\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\"\n },\n \"declared_stock\": 250\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6114a664-c325-4166-9b83-e1e57356ad47", "name": "Offer detail (including stock and health)", "request": { "name": "Offer detail (including stock and health)", "description": { "content": "The full offer object. `health` is read-only: score 0–100 (routing requires ≥ 70), routing eligibility, and any active cooldown.", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "5bf01ef1-a2de-4725-ab12-8b9702bcf935", "name": "The offer.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"status\": \"active\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"delivery_time\": \"instant\",\n \"low_stock_threshold\": 10,\n \"stock\": {\n \"mode\": \"declared\",\n \"declared\": 250,\n \"available\": null,\n \"reserved\": null,\n \"delivered\": 8811\n },\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\",\n \"secret_set\": true,\n \"last_healthcheck_at\": \"2026-07-11T13:55:00Z\",\n \"last_healthcheck_ok\": true\n },\n \"health\": {\n \"score\": 96,\n \"routing_eligible\": true,\n \"cooldown_until\": null\n },\n \"created_at\": \"2026-06-05T11:20:00Z\",\n \"updated_at\": \"2026-07-11T13:58:12Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10f4b051-3ee8-4cac-9916-ebfde51ced56", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd4dc275-00a7-4833-ae68-55c02a40daef", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "923fedd1-9b95-4d8f-a86f-aa285d6d1243", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc973e14-27bb-4da8-9dda-eacab24d4b82", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bfb22efb-294a-4280-a912-79afaffb48c8", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dd853ae9-ed80-4062-baf4-a6086e7b2350", "name": "Update an offer", "request": { "name": "Update an offer", "description": { "content": "Partial update of `price`, `external_ref`, `low_stock_threshold`,\n`fulfilment.base_url`, `declared_stock`. Changing `fulfilment.base_url` on an\n**active** offer triggers an inline healthcheck against the new URL —\n`422` / `fulfilment_unreachable` on failure, and nothing is changed.\n", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"low_stock_threshold\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "76a2cd48-95a3-468c-94ae-93645f23f55c", "name": "The updated offer.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"low_stock_threshold\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"status\": \"active\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"delivery_time\": \"instant\",\n \"low_stock_threshold\": 10,\n \"stock\": {\n \"mode\": \"declared\",\n \"declared\": 250,\n \"available\": null,\n \"reserved\": null,\n \"delivered\": 8811\n },\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\",\n \"secret_set\": true,\n \"last_healthcheck_at\": \"2026-07-11T13:55:00Z\",\n \"last_healthcheck_ok\": true\n },\n \"health\": {\n \"score\": 96,\n \"routing_eligible\": true,\n \"cooldown_until\": null\n },\n \"created_at\": \"2026-06-05T11:20:00Z\",\n \"updated_at\": \"2026-07-11T14:05:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7bbc78a5-4615-499b-b404-ceb0670e8e61", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"low_stock_threshold\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c24b80e-64aa-4d26-9d11-48b749799073", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"low_stock_threshold\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f537c572-9833-4519-bce7-f6cffdafc21f", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"low_stock_threshold\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4c4e150-7a3e-404e-b5b5-51a5afb8711b", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"low_stock_threshold\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "14e76840-f42c-48f2-88bd-c566bf2f8c68", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"low_stock_threshold\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31f1b22b-81e1-496e-a877-1e4a113c6774", "name": "`validation_failed` or `fulfilment_unreachable` (inline healthcheck against new URL failed).", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"low_stock_threshold\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#fulfilment_unreachable\",\n \"title\": \"Fulfilment endpoint unreachable\",\n \"status\": 422,\n \"detail\": \"GET https://new.keyforge.example/ck/healthcheck: timeout after 5000ms.\",\n \"code\": \"fulfilment_unreachable\",\n \"trace_id\": \"req_77aa1b2c3d4e5f60\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a6750b0-13d7-4cac-9b4e-18de3ae78298", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"low_stock_threshold\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6dfa925d-15c0-44b7-b5da-55c47901b873", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"low_stock_threshold\": 10\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "becc6168-2fe8-4600-9368-4c594ff56abe", "name": "Archive an offer (terminal)", "request": { "name": "Archive an offer (terminal)", "description": { "content": "Archives the offer — a terminal state. Remaining `available` inventory items are auto-invalidated. In-flight orders complete normally.", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": [], "auth": null }, "response": [ { "id": "28433078-82ff-4293-ae41-91f71786fd1c", "name": "The archived offer.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"status\": \"archived\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"delivery_time\": \"instant\",\n \"low_stock_threshold\": 10,\n \"stock\": {\n \"mode\": \"declared\",\n \"declared\": 0,\n \"available\": null,\n \"reserved\": null,\n \"delivered\": 8811\n },\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\",\n \"secret_set\": true,\n \"last_healthcheck_at\": \"2026-07-11T13:55:00Z\",\n \"last_healthcheck_ok\": true\n },\n \"health\": {\n \"score\": 96,\n \"routing_eligible\": false,\n \"cooldown_until\": null\n },\n \"created_at\": \"2026-06-05T11:20:00Z\",\n \"updated_at\": \"2026-07-11T14:10:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52a5d27d-55fe-4c0c-a5ed-886117f9be92", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8af07935-4b07-4f15-a332-68480f5b085a", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3d269245-b57c-4ec1-9a82-06da6378c1f9", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f5631b8a-5b79-4535-af9f-f1df5c8ddd6d", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "393d9c7b-a8c7-4ce1-831f-2ed14518e60d", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a5ccbe5a-22a9-4ed6-a420-84a4d14c3bc5", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "065f19b5-a7bf-4c24-9e75-c3b245a5d2c3", "name": "Activate an offer", "request": { "name": "Activate an offer", "description": { "content": "No request body. Preconditions: the product is `sellable`; for `declared`/top-up\noffers a **live healthcheck runs inline** — failure returns\n`422` / `fulfilment_unreachable` with the probe result in `detail`. Activating an\n`uploaded` offer with zero stock succeeds but the offer stays unroutable until stock\narrives. Wrong state (e.g. `archived`) → `409` / `invalid_state`.\n", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id", "activate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": [], "auth": null }, "response": [ { "id": "c62c86b4-4062-442d-ae25-9d9a8d6f2e36", "name": "The offer, now `status: active`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "activate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"status\": \"active\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"delivery_time\": \"instant\",\n \"low_stock_threshold\": 10,\n \"stock\": {\n \"mode\": \"declared\",\n \"declared\": 250,\n \"available\": null,\n \"reserved\": null,\n \"delivered\": 0\n },\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\",\n \"secret_set\": true,\n \"last_healthcheck_at\": \"2026-07-11T14:00:00Z\",\n \"last_healthcheck_ok\": true\n },\n \"health\": {\n \"score\": 100,\n \"routing_eligible\": true,\n \"cooldown_until\": null\n },\n \"created_at\": \"2026-06-05T11:20:00Z\",\n \"updated_at\": \"2026-07-11T14:00:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "496b9909-55f2-4f99-9ff1-b497cd1eacec", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "activate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "81c621a5-6807-4681-a493-5d5a1b207f20", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "activate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bbe911c-f755-4ee0-92f7-b7ff6cbc88dc", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "activate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae6b1d5e-8c2f-4a1b-9a4e-94fc488103c1", "name": "`invalid_state` — transition not allowed from the current status.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "activate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#invalid_state\",\n \"title\": \"Invalid state\",\n \"status\": 409,\n \"detail\": \"An archived offer cannot be activated.\",\n \"code\": \"invalid_state\",\n \"trace_id\": \"req_31f0aa92bb7c4d55\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b39c2aa0-b908-41ce-a0d6-1f89e9ddb752", "name": "`fulfilment_unreachable` (inline healthcheck failed) or `product_not_sellable`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "activate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#fulfilment_unreachable\",\n \"title\": \"Fulfilment endpoint unreachable\",\n \"status\": 422,\n \"detail\": \"GET https://api.keyforge.example/ck/healthcheck: HTTP 503 after 5002ms.\",\n \"code\": \"fulfilment_unreachable\",\n \"trace_id\": \"req_8e21c4f6a9b04d13\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0486ddf7-8f79-4291-ae3a-9e18472311c2", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "activate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca433c6a-19c5-46e0-9e1c-7ba960b87314", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "activate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "44450437-542a-40c0-a546-1aa9b549605d", "name": "Deactivate an offer", "request": { "name": "Deactivate an offer", "description": { "content": "No request body. The offer is immediately removed from routing; open reservations\nand orders still complete. Fires `offer.deactivated` (reason `supplier_request`) to\nyour webhook endpoints.\n", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": [], "auth": null }, "response": [ { "id": "a138d267-fcec-4eb0-8d9d-3c968b7cd45a", "name": "The offer, now `status: paused`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"status\": \"paused\",\n \"stock_mode\": \"declared\",\n \"price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"delivery_time\": \"instant\",\n \"low_stock_threshold\": 10,\n \"stock\": {\n \"mode\": \"declared\",\n \"declared\": 250,\n \"available\": null,\n \"reserved\": null,\n \"delivered\": 8811\n },\n \"fulfilment\": {\n \"base_url\": \"https://api.keyforge.example/ck\",\n \"secret_set\": true,\n \"last_healthcheck_at\": \"2026-07-11T13:55:00Z\",\n \"last_healthcheck_ok\": true\n },\n \"health\": {\n \"score\": 96,\n \"routing_eligible\": false,\n \"cooldown_until\": null\n },\n \"created_at\": \"2026-06-05T11:20:00Z\",\n \"updated_at\": \"2026-07-11T14:12:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54d4bf8d-33b4-460f-9c79-4d691948d50c", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e84339c6-1c7a-4869-b660-d2872977db59", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f6a1163-fedd-4c45-af1f-82318f06fffd", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b8137bc-d7df-4c5e-866b-ba9897628cfc", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40fa51ed-a325-491a-9dcb-982121dd3f80", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5ef9d4fb-48f1-4196-928c-cb4062c49c96", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1110bea4-7f34-4ef8-b724-604a3a340d26", "name": "Fast price update (repricer lane)", "request": { "name": "Fast price update (repricer lane)", "description": { "content": "Repricer fast lane — 300/min (`sync` class), no price-change fees, ever.\nInherently idempotent (PUT); no `Idempotency-Key`.\n", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id", "price" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "42eb7649-5664-412e-9eb0-789b47926342", "name": "New price confirmed.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "price" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n },\n \"updated_at\": \"2026-07-11T14:01:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0bd4e8d6-17b3-4e3f-a36b-bfb79ee34c99", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "price" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b9040f1-d543-4452-a39c-b6d914d3cada", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "price" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a006deea-39f6-425d-9647-00ffa1464837", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "price" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7270c972-cafb-4bc6-bd43-95fde116ccdd", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "price" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72d6d7ef-c629-4e6b-aa7c-8b3a2875fa98", "name": "`validation_failed` — field-level validation; the `errors` map contains field → messages.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "price" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#validation_failed\",\n \"title\": \"Validation failed\",\n \"status\": 422,\n \"detail\": \"price.amount must be a positive integer.\",\n \"code\": \"validation_failed\",\n \"errors\": {\n \"price.amount\": [\n \"must be a positive integer\"\n ]\n },\n \"trace_id\": \"req_9f3b2c61a8d44e0f\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd7291c6-730e-4915-b44e-4f93c8d7895d", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "price" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af0a2932-d81d-47a2-8a73-d1e663989163", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "price" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"price\": {\n \"amount\": 1899,\n \"currency\": \"EUR\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0f43662e-a1dc-44ff-90d9-be102f0833c9", "name": "Declare stock count (declared mode)", "request": { "name": "Declare stock count (declared mode)", "description": { "content": "Sets the self-declared stock count — a routing signal, not a promise (the\nreservation call is the truth). `0` makes the offer unroutable without deactivating\nit. On an `uploaded` offer → `409` / `stock_mode_mismatch`.\n", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"declared_stock\": 175\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "fa1ba875-4789-4e28-bca1-9bd9435714af", "name": "New declared count confirmed.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"declared_stock\": 175\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"declared_stock\": 175,\n \"updated_at\": \"2026-07-11T14:02:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c78e1031-19b8-497f-91dd-a848a35b6ca9", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"declared_stock\": 175\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26482dec-6840-4a3c-9888-46f879dce604", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"declared_stock\": 175\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3028577-85a1-49c8-957a-226be38783f4", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"declared_stock\": 175\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9bfbd54d-154f-4361-9e3f-816a1eb2d73e", "name": "`stock_mode_mismatch` — stock declaration on an uploaded offer.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"declared_stock\": 175\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#stock_mode_mismatch\",\n \"title\": \"Stock mode mismatch\",\n \"status\": 409,\n \"detail\": \"This offer uses uploaded stock; declared counts do not apply.\",\n \"code\": \"stock_mode_mismatch\",\n \"trace_id\": \"req_c4d5e6f708192a3b\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "957ffb30-4f97-45f3-a8c5-7b8ac1f044fd", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"declared_stock\": 175\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af3e83a9-09ff-4803-9071-7667d8d23afa", "name": "`validation_failed` — field-level validation; the `errors` map contains field → messages.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"declared_stock\": 175\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#validation_failed\",\n \"title\": \"Validation failed\",\n \"status\": 422,\n \"detail\": \"price.amount must be a positive integer.\",\n \"code\": \"validation_failed\",\n \"errors\": {\n \"price.amount\": [\n \"must be a positive integer\"\n ]\n },\n \"trace_id\": \"req_9f3b2c61a8d44e0f\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dfae0d11-ce2b-4dce-a2cd-b67abf02a793", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"declared_stock\": 175\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "acd75f6b-aca0-4745-adcc-8b8b54f31aed", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"declared_stock\": 175\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "37a5664d-51f4-4abb-9ec3-181d24cb5b32", "name": "Run a fulfilment healthcheck now", "request": { "name": "Run a fulfilment healthcheck now", "description": { "content": "Runs `GET {base_url}/healthcheck` against the offer's configured fulfilment endpoint\nimmediately and returns the probe result. A failed probe is still HTTP `200` here —\nthe check ran; the *result* failed. Rate class `test` (6/min).\n", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id", "fulfilment", "check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": [], "auth": null }, "response": [ { "id": "1c9bb54f-70e2-4c93-ad0b-b3ea55da7956", "name": "Probe result (ok or failed).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"status\": \"ok\",\n \"http_status\": 200,\n \"latency_ms\": 142,\n \"checked_at\": \"2026-07-11T14:02:10Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb52cd33-6542-4099-9ee8-967c09a74d47", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e358033-6bd7-4621-aceb-21c9b56a1a49", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3f71090-67cf-4f63-9179-30bf4e6089c9", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "838edb24-202d-4be0-86f8-3f0f415ac4a0", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7fb8e43e-fe50-4378-bd43-45d0f67533a0", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6cbd2422-075c-455e-9829-20cf5c7f74a3", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4928a7c4-1485-4a21-a065-3d478002abab", "name": "Rotate the fulfilment callback secret", "request": { "name": "Rotate the fulfilment callback secret", "description": { "content": "Returns a new `cksec_` secret — shown only in this response. Takes effect\nimmediately: hold both old and new secrets during rollout, verify incoming\nsignatures against either, then drop the old.\n", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id", "fulfilment", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": [], "auth": null }, "response": [ { "id": "d41b6689-7134-4d61-92fb-256d93625c4b", "name": "The new secret.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"secret\": \"cksec_3b8e1f6a2c9d4e7f0a5b8c1d4e7f0a3b\",\n \"rotated_at\": \"2026-07-11T14:06:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d29f7e0a-80f8-420b-8039-94bcb1329854", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89ca61f1-e18c-403e-b97c-b966f2edb6b3", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8945104a-83bf-4e50-8762-c4ae079994a9", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5df625a-dba0-4556-bba2-2444a992facf", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a550439f-1c18-4e65-b41e-6a28ccc6af36", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "775094bb-da0a-4e9e-a564-f8fded57ab60", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "fulfilment", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Inventory", "description": "Pre-uploaded deliverables (uploaded stock mode). Encrypted at rest on arrival.", "item": [ { "id": "3688d9d0-bdf5-4937-bb99-4b719f983b8e", "name": "Bulk upload keys / codes / files", "request": { "name": "Bulk upload keys / codes / files", "description": { "content": "Only for `stock_mode: uploaded` offers (`409` / `stock_mode_mismatch` otherwise).\nLimits: **1–1,000 items per request**; `text` values 1–1,024 chars; `file` content\n≤ **200 KB decoded**, types `application/pdf`, `image/png`, `image/jpeg`; total body\n≤ 1 MB. **Send `Idempotency-Key`** — networks drop, keys must not double-insert.\n\n- `mode: strict` (default) — all-or-nothing: any invalid item →\n `422` / `inventory_rejected` with per-item errors under `rejected_items`,\n **nothing stored**.\n- `mode: partial` — valid items stored, invalid ones reported in `rejected`.\n\nDuplicate detection: SHA-256 fingerprint of the exact value (or file bytes) per\noffer; an item matching any non-invalidated existing item is `duplicate_item`.\nDeliverables are encrypted at rest the moment they arrive; the API never returns a\nfull value after upload.\n", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "79e5fc9d-edb9-46f6-9ae6-775850da101c", "name": "Items stored (strict success, or partial with per-item rejections).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"accepted\": 2,\n \"rejected\": [\n {\n \"index\": 2,\n \"code\": \"duplicate_item\",\n \"message\": \"Identical item already exists on this offer.\"\n }\n ],\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ],\n \"stock_available\": 1042\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5fc4eab-6719-4a0c-bf67-1a88c4d19567", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8df0194a-04fb-4de1-ab6a-6ca8e938c840", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fda7d635-03bf-4cff-9cc9-e8ffe29bff31", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b5a72f6-8a79-44e0-a9c3-655520579b15", "name": "`stock_mode_mismatch` (declared offer) or an idempotency conflict.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#stock_mode_mismatch\",\n \"title\": \"Stock mode mismatch\",\n \"status\": 409,\n \"detail\": \"Inventory upload is only available on uploaded-stock offers.\",\n \"code\": \"stock_mode_mismatch\",\n \"trace_id\": \"req_0a1b2c3d4e5f6071\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c768e563-6ae4-42d8-b6b3-a31a260d9e3c", "name": "`payload_too_large` — body exceeds 1 MB; split the batch.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Request Entity Too Large", "code": 413, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#payload_too_large\",\n \"title\": \"Payload too large\",\n \"status\": 413,\n \"detail\": \"Request body exceeds 1 MB.\",\n \"code\": \"payload_too_large\",\n \"trace_id\": \"req_a1b2c3d4e5f60718\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a095c34d-b9de-4f5b-bce9-86ebe91224d2", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "983c7944-ff02-4baf-ac65-35ced3229127", "name": "`inventory_rejected` — strict-mode upload had invalid items; per-item errors in `rejected_items`, nothing stored. Or `validation_failed` for malformed envelope.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#inventory_rejected\",\n \"title\": \"Inventory rejected\",\n \"status\": 422,\n \"detail\": \"1 of 3 items is invalid; strict mode stored nothing.\",\n \"code\": \"inventory_rejected\",\n \"rejected_items\": [\n {\n \"index\": 2,\n \"code\": \"duplicate_item\",\n \"message\": \"Identical item already exists on this offer.\"\n }\n ],\n \"trace_id\": \"req_6f7a8b9c0d1e2f30\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a7958ad1-857b-4e59-b011-8f51425ccb71", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "73b46335-93cb-4b4d-8647-764e5064e78f", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mode\": \"strict\",\n \"items\": [\n {\n \"kind\": \"text\",\n \"value\": \"AAAA-BBBB-CCCC-DDDD\"\n },\n {\n \"kind\": \"text\",\n \"value\": \"EEEE-FFFF-GGGG-HHHH\"\n },\n {\n \"kind\": \"file\",\n \"file_name\": \"giftcard-0042.pdf\",\n \"content_type\": \"application/pdf\",\n \"content_base64\": \"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK…\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "44283e23-709c-4042-8c63-330146679781", "name": "List inventory items", "request": { "name": "List inventory items", "description": { "content": "Paginated inventory listing. `value_preview` shows the first 4 characters with the remainder masked — enough to reconcile, useless to steal.", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of available,reserved,delivered,returned,invalidated)", "type": "text/plain" }, "key": "state", "value": "available" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "32bc850f-771a-4cc2-b08e-ae27799121f5", "name": "A page of inventory items.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of available,reserved,delivered,returned,invalidated)", "type": "text/plain" }, "key": "state", "value": "available" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"kind\": \"text\",\n \"state\": \"delivered\",\n \"value_preview\": \"AAAA-••••-••••-••••\",\n \"fingerprint\": \"sha256:9f8a1c…e2d4\",\n \"file_name\": null,\n \"uploaded_at\": \"2026-07-01T09:00:00Z\",\n \"delivered_order_id\": \"01JZY2H8K4M6N8P0Q2R4S6T8V0\",\n \"state_changed_at\": \"2026-07-11T14:03:40Z\"\n }\n ],\n \"next_cursor\": \"eyJrIjoiMDFKWldZNlAifQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f64873e-07fe-43bb-b800-937a4681c578", "name": "`invalid_json`, `invalid_cursor`, or `idempotency_key_invalid`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of available,reserved,delivered,returned,invalidated)", "type": "text/plain" }, "key": "state", "value": "available" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#invalid_cursor\",\n \"title\": \"Invalid cursor\",\n \"status\": 400,\n \"detail\": \"This pagination cursor is unknown or has expired; restart without a cursor.\",\n \"code\": \"invalid_cursor\",\n \"trace_id\": \"req_1a2b3c4d5e6f7081\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "abe3c4d7-e927-4346-b5c9-44f3e6bd0268", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of available,reserved,delivered,returned,invalidated)", "type": "text/plain" }, "key": "state", "value": "available" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "caf7b01f-b78e-4275-a8b2-40a11f5d6701", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of available,reserved,delivered,returned,invalidated)", "type": "text/plain" }, "key": "state", "value": "available" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "135ea2ce-c0a2-4498-8513-537131fadb3f", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of available,reserved,delivered,returned,invalidated)", "type": "text/plain" }, "key": "state", "value": "available" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8647f9f2-424a-4af3-9e57-f616f209670f", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of available,reserved,delivered,returned,invalidated)", "type": "text/plain" }, "key": "state", "value": "available" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "269d8338-161f-454e-ac23-33fc973e0e7a", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of available,reserved,delivered,returned,invalidated)", "type": "text/plain" }, "key": "state", "value": "available" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uploaded_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c9acc4b5-42d3-4ecd-a2fb-08e24bac4392", "name": "Invalidate available items (bulk)", "request": { "name": "Invalidate available items (bulk)", "description": { "content": "Pull items from sale (compromised batch, publisher revocation). Only `available`\nitems can be invalidated; others are reported in `skipped` with their current state.\n1–100 ids per call. If invalidation drops stock to/below `low_stock_threshold`,\n`offer.stock_low` fires.\n", "type": "text/plain" }, "url": { "path": [ "offers", ":offer_id", "inventory", "invalidate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id", "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "5b4cd8cc-74ba-4581-83a3-7f045289e5f1", "name": "Invalidation result with per-item skips.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory", "invalidate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"invalidated\": 1,\n \"skipped\": [\n {\n \"id\": \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"code\": \"invalid_state\",\n \"state\": \"delivered\"\n }\n ],\n \"stock_available\": 1040\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4a5e180-2b42-40fc-90e1-a143fa810824", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory", "invalidate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5e0bd4f4-8a1c-4358-94b2-54e0a03a3915", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory", "invalidate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6abc93ed-168c-4045-b553-ad2aca2bc8ec", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory", "invalidate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb87d267-d7b0-44c7-8ba9-f85a3dd93fff", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory", "invalidate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "327299b5-6e00-4dca-8f83-708120a1b228", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory", "invalidate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dbaffd23-9948-4bdf-a3bc-8294b303431d", "name": "`validation_failed` — field-level validation; the `errors` map contains field → messages.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory", "invalidate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#validation_failed\",\n \"title\": \"Validation failed\",\n \"status\": 422,\n \"detail\": \"price.amount must be a positive integer.\",\n \"code\": \"validation_failed\",\n \"errors\": {\n \"price.amount\": [\n \"must be a positive integer\"\n ]\n },\n \"trace_id\": \"req_9f3b2c61a8d44e0f\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7573031-2f27-46ed-8cbc-8e415c441ac6", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory", "invalidate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "697f93ec-796e-4245-82ed-838551e51f3e", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "offers", ":offer_id", "inventory", "invalidate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Offer ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "offer_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"item_ids\": [\n \"01JZWY6P2R4T6V8X0Z2B4D6F8H\",\n \"01JZWY6P2SAB4CD6EF8GH0JK2M\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Orders", "description": "Read model — every order containing at least one of your items, with only your items, and no buyer PII beyond buyer_country.", "item": [ { "id": "d5a989af-6385-4297-8225-f61f3dc33110", "name": "List orders containing your items", "request": { "name": "List orders containing your items", "description": { "content": "Every order containing at least one of your items, with **only your items**, and no\nbuyer PII beyond `buyer_country`. Use `updated_since` for delta polling — but prefer\nwebhooks.\n", "type": "text/plain" }, "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of pending,provisioning,completed,partially_completed,failed,expired,partially_refunded,refunded)", "type": "text/plain" }, "key": "status", "value": "partially_refunded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offer_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "603bd816-ac97-41e7-8d56-5ee1bddaf7d7", "name": "A page of orders (supplier-scoped view).", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of pending,provisioning,completed,partially_completed,failed,expired,partially_refunded,refunded)", "type": "text/plain" }, "key": "status", "value": "partially_refunded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offer_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"01JZY2H8K4M6N8P0Q2R4S6T8V0\",\n \"number\": \"CK-01JZY2H8K4M6N8P0Q2R4S6T8V0\",\n \"status\": \"completed\",\n \"buyer_country\": \"FR\",\n \"currency\": \"EUR\",\n \"created_at\": \"2026-07-11T14:02:58Z\",\n \"paid_at\": \"2026-07-11T14:03:22Z\",\n \"completed_at\": \"2026-07-11T14:03:41Z\",\n \"items\": [\n {\n \"id\": \"01JZY2H8KFAB3CD5EF7GH9JK1M\",\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"quantity\": 1,\n \"unit_price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"gross\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"commission\": {\n \"amount\": 170,\n \"currency\": \"EUR\"\n },\n \"net\": {\n \"amount\": 1829,\n \"currency\": \"EUR\"\n },\n \"status\": \"delivered\",\n \"fulfilment\": {\n \"source\": \"declared\",\n \"reservation_id\": \"01JZY2G7Q3W5E7R9T1Y3A5S7DF\",\n \"inventory_item_ids\": null\n },\n \"delivered_at\": \"2026-07-11T14:03:40Z\"\n }\n ],\n \"totals\": {\n \"gross\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"commission\": {\n \"amount\": 170,\n \"currency\": \"EUR\"\n },\n \"net\": {\n \"amount\": 1829,\n \"currency\": \"EUR\"\n }\n }\n }\n ],\n \"next_cursor\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a3ce5e77-6403-4cc0-9aba-c03117376b0b", "name": "`invalid_json`, `invalid_cursor`, or `idempotency_key_invalid`.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of pending,provisioning,completed,partially_completed,failed,expired,partially_refunded,refunded)", "type": "text/plain" }, "key": "status", "value": "partially_refunded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offer_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#invalid_cursor\",\n \"title\": \"Invalid cursor\",\n \"status\": 400,\n \"detail\": \"This pagination cursor is unknown or has expired; restart without a cursor.\",\n \"code\": \"invalid_cursor\",\n \"trace_id\": \"req_1a2b3c4d5e6f7081\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d033a5d-5406-4a8d-bff5-77c6eb9b7ae1", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of pending,provisioning,completed,partially_completed,failed,expired,partially_refunded,refunded)", "type": "text/plain" }, "key": "status", "value": "partially_refunded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offer_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15a15261-5bcc-40d2-9756-9fcf9601c975", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of pending,provisioning,completed,partially_completed,failed,expired,partially_refunded,refunded)", "type": "text/plain" }, "key": "status", "value": "partially_refunded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offer_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72f85f82-aff4-4e31-acce-dc085f662643", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of pending,provisioning,completed,partially_completed,failed,expired,partially_refunded,refunded)", "type": "text/plain" }, "key": "status", "value": "partially_refunded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offer_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68ffa722-691b-4dc9-a473-b7459a921d44", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of pending,provisioning,completed,partially_completed,failed,expired,partially_refunded,refunded)", "type": "text/plain" }, "key": "status", "value": "partially_refunded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "updated_since", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "product_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offer_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1d2486ac-836c-4e9d-95d4-e335a7de960c", "name": "Order detail (supplier-scoped)", "request": { "name": "Order detail (supplier-scoped)", "description": { "content": "The order with only your items. `fulfilment.source` is `uploaded` (carries\n`inventory_item_ids`), `declared` (carries `reservation_id`), or `topup` (carries\n`operation_id`). Totals cover **your** items only. Commission math:\n`max(round_half_up(gross × 0.085), 5)` per item.\n", "type": "text/plain" }, "url": { "path": [ "orders", ":order_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "order_id", "disabled": false, "description": { "content": "(Required) Order ULID (bare, without the `CK-` prefix).", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "19c81c71-12a2-42ae-bf3e-cf510a1dd69a", "name": "The order.", "originalRequest": { "url": { "path": [ "orders", ":order_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Order ULID (bare, without the `CK-` prefix).", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "order_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"id\": \"01JZY2H8K4M6N8P0Q2R4S6T8V0\",\n \"number\": \"CK-01JZY2H8K4M6N8P0Q2R4S6T8V0\",\n \"status\": \"completed\",\n \"buyer_country\": \"FR\",\n \"currency\": \"EUR\",\n \"created_at\": \"2026-07-11T14:02:58Z\",\n \"paid_at\": \"2026-07-11T14:03:22Z\",\n \"completed_at\": \"2026-07-11T14:03:41Z\",\n \"items\": [\n {\n \"id\": \"01JZY2H8KFAB3CD5EF7GH9JK1M\",\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"quantity\": 1,\n \"unit_price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"gross\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"commission\": {\n \"amount\": 170,\n \"currency\": \"EUR\"\n },\n \"net\": {\n \"amount\": 1829,\n \"currency\": \"EUR\"\n },\n \"status\": \"delivered\",\n \"fulfilment\": {\n \"source\": \"declared\",\n \"reservation_id\": \"01JZY2G7Q3W5E7R9T1Y3A5S7DF\",\n \"inventory_item_ids\": null\n },\n \"delivered_at\": \"2026-07-11T14:03:40Z\"\n }\n ],\n \"totals\": {\n \"gross\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"commission\": {\n \"amount\": 170,\n \"currency\": \"EUR\"\n },\n \"net\": {\n \"amount\": 1829,\n \"currency\": \"EUR\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31c5d960-033a-494f-84f3-811dd0f127cc", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "orders", ":order_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Order ULID (bare, without the `CK-` prefix).", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "order_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "613a98a1-b524-4a02-91bc-eb6c5a5b0439", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "orders", ":order_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Order ULID (bare, without the `CK-` prefix).", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "order_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b38a6f08-2aad-47fb-9e1f-f4851e0c69e2", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "orders", ":order_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Order ULID (bare, without the `CK-` prefix).", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "order_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a52900c8-e039-4beb-8abd-8229bcbaee72", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "orders", ":order_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Order ULID (bare, without the `CK-` prefix).", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "order_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63b2975a-6816-4e2a-b519-d1aa885d3283", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "orders", ":order_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Order ULID (bare, without the `CK-` prefix).", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "order_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Balance", "description": "Available + pending balance and the append-only ledger.", "item": [ { "id": "fddfd929-8b14-41be-a766-5715637d55f7", "name": "Available + pending balance", "request": { "name": "Available + pending balance", "description": { "content": "`pending` = net proceeds inside the 7-day holding period (10 minutes in sandbox). Payout execution is portal-only in v1; payouts appear in the ledger.", "type": "text/plain" }, "url": { "path": [ "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "4799c75a-3890-4b9e-98ad-98bf836448c9", "name": "Current balances.", "originalRequest": { "url": { "path": [ "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"currency\": \"EUR\",\n \"available\": {\n \"amount\": 184230,\n \"currency\": \"EUR\"\n },\n \"pending\": {\n \"amount\": 12704,\n \"currency\": \"EUR\"\n },\n \"updated_at\": \"2026-07-11T14:00:05Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "caa70b60-0c7f-425b-91a3-b42ac8b4d043", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a1ccafb-3f8b-417e-bad4-e5223d21cf42", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f48aae6e-845e-4e6b-9ea7-1b807b9772de", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5443960d-0e52-4259-8a76-cd90c5b55596", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "370f51d9-e981-4afe-bf67-5cf7055ce91b", "name": "Ledger entries", "request": { "name": "Ledger entries", "description": { "content": "Append-only ledger (schema canonical in 01-data-model.md §2.7 — one row per economic\nevent with gross/commission/net; `amount` is the net, `breakdown` the split). `sale`\ncredits the **net**, created at delivery, `pending` until `available_at`.\n`refund_reversal` / `invalidation_chargeback` debit exactly the net of the affected\nitems — commission is returned to you (symmetric; no fee kept on refunds). `payout`,\n`payout_reversal` and `adjustment` (staff, always carries `description`) are signed\naccordingly. Amounts can be negative.\n", "type": "text/plain" }, "url": { "path": [ "balance", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of sale,refund_reversal,invalidation_chargeback,payout,payout_reversal,adjustment)", "type": "text/plain" }, "key": "type", "value": "invalidation_chargeback" }, { "disabled": false, "description": { "content": " (This can only be one of pending,settled)", "type": "text/plain" }, "key": "status", "value": "pending" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "16f935b7-ebf2-47ce-bd00-19c357b8b73d", "name": "A page of ledger entries.", "originalRequest": { "url": { "path": [ "balance", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of sale,refund_reversal,invalidation_chargeback,payout,payout_reversal,adjustment)", "type": "text/plain" }, "key": "type", "value": "invalidation_chargeback" }, { "disabled": false, "description": { "content": " (This can only be one of pending,settled)", "type": "text/plain" }, "key": "status", "value": "pending" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"01JZY4C3D5F7H9K1M3P5R7T9V1\",\n \"type\": \"sale\",\n \"amount\": {\n \"amount\": 1829,\n \"currency\": \"EUR\"\n },\n \"breakdown\": {\n \"gross\": 1999,\n \"commission\": 170\n },\n \"status\": \"pending\",\n \"available_at\": \"2026-07-18T14:03:40Z\",\n \"order_id\": \"01JZY2H8K4M6N8P0Q2R4S6T8V0\",\n \"order_item_id\": \"01JZY2H8KFAB3CD5EF7GH9JK1M\",\n \"description\": null,\n \"created_at\": \"2026-07-11T14:03:40Z\"\n },\n {\n \"id\": \"01JZY4C4E6G8J0K2M4N6P8Q0R2\",\n \"type\": \"payout\",\n \"amount\": {\n \"amount\": -150000,\n \"currency\": \"EUR\"\n },\n \"breakdown\": null,\n \"status\": \"settled\",\n \"available_at\": null,\n \"order_id\": null,\n \"order_item_id\": null,\n \"description\": \"SEPA payout #2026-018\",\n \"created_at\": \"2026-07-08T06:00:00Z\"\n }\n ],\n \"next_cursor\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd6c4651-23b1-4a5d-9c37-4a6f4f09f022", "name": "`invalid_json`, `invalid_cursor`, or `idempotency_key_invalid`.", "originalRequest": { "url": { "path": [ "balance", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of sale,refund_reversal,invalidation_chargeback,payout,payout_reversal,adjustment)", "type": "text/plain" }, "key": "type", "value": "invalidation_chargeback" }, { "disabled": false, "description": { "content": " (This can only be one of pending,settled)", "type": "text/plain" }, "key": "status", "value": "pending" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#invalid_cursor\",\n \"title\": \"Invalid cursor\",\n \"status\": 400,\n \"detail\": \"This pagination cursor is unknown or has expired; restart without a cursor.\",\n \"code\": \"invalid_cursor\",\n \"trace_id\": \"req_1a2b3c4d5e6f7081\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dab8b28a-8694-40f9-8447-178cc820e5a5", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "balance", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of sale,refund_reversal,invalidation_chargeback,payout,payout_reversal,adjustment)", "type": "text/plain" }, "key": "type", "value": "invalidation_chargeback" }, { "disabled": false, "description": { "content": " (This can only be one of pending,settled)", "type": "text/plain" }, "key": "status", "value": "pending" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b73a43b-e532-406d-877a-a63cf77bf859", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "balance", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of sale,refund_reversal,invalidation_chargeback,payout,payout_reversal,adjustment)", "type": "text/plain" }, "key": "type", "value": "invalidation_chargeback" }, { "disabled": false, "description": { "content": " (This can only be one of pending,settled)", "type": "text/plain" }, "key": "status", "value": "pending" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34dfb09b-0d71-47d3-9518-bb7ac067f0f1", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "balance", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of sale,refund_reversal,invalidation_chargeback,payout,payout_reversal,adjustment)", "type": "text/plain" }, "key": "type", "value": "invalidation_chargeback" }, { "disabled": false, "description": { "content": " (This can only be one of pending,settled)", "type": "text/plain" }, "key": "status", "value": "pending" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f93a18d6-c7e0-4c5a-bcb4-31c0b8abf88c", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "balance", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of sale,refund_reversal,invalidation_chargeback,payout,payout_reversal,adjustment)", "type": "text/plain" }, "key": "type", "value": "invalidation_chargeback" }, { "disabled": false, "description": { "content": " (This can only be one of pending,settled)", "type": "text/plain" }, "key": "status", "value": "pending" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Webhooks", "description": "Webhook endpoint CRUD, secret rotation, test-fire.", "item": [ { "id": "b2c8c9db-2e7d-42e9-ac56-724927bd0f7f", "name": "List webhook endpoints", "request": { "name": "List webhook endpoints", "description": { "content": "Endpoints are returned without their `secret` (shown once at creation).", "type": "text/plain" }, "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "cf00c316-946a-403b-a17e-3867b9f6ec54", "name": "A page of webhook endpoints.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"01JZW0DC8FGH2JK4MN6PQ8RS0T\",\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\",\n \"status\": \"active\",\n \"consecutive_failures\": 0,\n \"disabled_at\": null,\n \"created_at\": \"2026-07-11T10:00:00Z\"\n }\n ],\n \"next_cursor\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1d29230b-4b67-416c-a71d-38c990ea6921", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0da7bf41-c770-4ce1-a211-8a9910d7267f", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6c43938-7ddf-4f11-a8ab-56126727d7f4", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f6c32f15-0e47-475d-9399-fd2c9bb835b2", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0c6dac3e-a554-4683-82aa-eaed825de30c", "name": "Create a webhook endpoint (secret shown once)", "request": { "name": "Create a webhook endpoint (secret shown once)", "description": { "content": "Max **10 endpoints** per supplier per environment. `events` is any subset of the\nevent catalog, or `[\"*\"]` for everything. URL rules: HTTPS, publicly resolvable, not\na private/link-local IP, ≤ 2,048 chars. The `201` response is **the only time the\nsigning secret (`whsec_…`) is shown** — store it; rotate to obtain a new one.\n", "type": "text/plain" }, "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "e9642995-0b62-4e9d-99ea-29267e6cdf7d", "name": "Endpoint created — includes the signing secret, shown once only.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"id\": \"01JZW0DC8FGH2JK4MN6PQ8RS0T\",\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\",\n \"status\": \"active\",\n \"secret\": \"whsec_4d9c2f81a7e35b60d1c8f42e9a0b7365\",\n \"consecutive_failures\": 0,\n \"disabled_at\": null,\n \"created_at\": \"2026-07-11T10:00:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9dd0db31-a904-4aaf-98ad-66858303e4e5", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "539bb908-3245-4f82-9e00-7d1c042c8b73", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d57484e7-d22f-42a0-8f18-333aed200b9a", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89c54ee2-3938-4d67-9689-5f221445dc07", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c72cf0a-4f59-4b18-b7a1-242e20765973", "name": "`validation_failed` — field-level validation; the `errors` map contains field → messages.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#validation_failed\",\n \"title\": \"Validation failed\",\n \"status\": 422,\n \"detail\": \"price.amount must be a positive integer.\",\n \"code\": \"validation_failed\",\n \"errors\": {\n \"price.amount\": [\n \"must be a positive integer\"\n ]\n },\n \"trace_id\": \"req_9f3b2c61a8d44e0f\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7dab3c2-b55d-4417-9f6a-91eb259a10eb", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e904caf4-3473-413c-b366-29dc45dcd5ab", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "af44dcb3-fe47-476f-b838-ff413b43a829", "name": "Webhook endpoint detail", "request": { "name": "Webhook endpoint detail", "description": { "content": "Same object as the list — never includes `secret`.", "type": "text/plain" }, "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id", "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "441db2a8-27ca-4135-9a9a-183d8f388e21", "name": "The endpoint.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"id\": \"01JZW0DC8FGH2JK4MN6PQ8RS0T\",\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\",\n \"status\": \"active\",\n \"consecutive_failures\": 0,\n \"disabled_at\": null,\n \"created_at\": \"2026-07-11T10:00:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b35fd3e7-a6f8-4a3c-ab53-57deb5401007", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d19f91f-3133-4ef6-8964-7e4f08ae78e4", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d9baf4ca-6cc8-4c59-88ed-63c632851eb9", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1bdee91a-e3bc-473d-831e-100043a82dda", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4192f781-bcc9-41ae-bea5-21c533573b53", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1138a8a5-c6ac-4819-91f6-00efd926e1df", "name": "Update URL / events / description / status", "request": { "name": "Update URL / events / description / status", "description": { "content": "Re-enabling a disabled endpoint (`status: active`) requires a passing 2xx test-fire first (409 / invalid_state otherwise) and resets `consecutive_failures` to 0.", "type": "text/plain" }, "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id", "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "04d428d3-ddd7-47fb-81a9-7ffca7b9d01e", "name": "The updated endpoint (no `secret`).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"id\": \"01JZW0DC8FGH2JK4MN6PQ8RS0T\",\n \"url\": \"https://api.keyforge.example/hooks/cheap-keys\",\n \"events\": [\n \"order.paid\",\n \"order.refunded\",\n \"order.disputed\",\n \"offer.stock_low\"\n ],\n \"description\": \"Main ERP intake\",\n \"status\": \"active\",\n \"consecutive_failures\": 0,\n \"disabled_at\": null,\n \"created_at\": \"2026-07-11T10:00:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d9521219-3b39-4e3f-aa85-4795eca3f2b3", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef7dc70d-b371-4401-a7aa-7fedf16c2991", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d76c3ef-7e62-4a99-8b59-168aa453af8d", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7db08902-bfc2-456b-8774-92b41fe59a12", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4db5309-68e2-4df2-b374-d736ff2b31b6", "name": "`validation_failed` — field-level validation; the `errors` map contains field → messages.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#validation_failed\",\n \"title\": \"Validation failed\",\n \"status\": 422,\n \"detail\": \"price.amount must be a positive integer.\",\n \"code\": \"validation_failed\",\n \"errors\": {\n \"price.amount\": [\n \"must be a positive integer\"\n ]\n },\n \"trace_id\": \"req_9f3b2c61a8d44e0f\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8963db6-397a-43b2-bdaa-7ac49ab23b31", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ed21113-735b-46c5-9ceb-5236b94f9838", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f4cda4b9-91cd-4dc6-9458-b04e7f810d8b", "name": "Delete a webhook endpoint", "request": { "name": "Delete a webhook endpoint", "description": [], "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id", "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": [], "auth": null }, "response": [ { "id": "85c8d4c7-e896-4bdd-aaa3-31349b1faa23", "name": "Deleted. No body.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "No Content", "code": 204, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "dc501ebc-0aea-44c2-886e-9affa991ca70", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72d5a40b-4027-4f38-9340-0ccb2e07f1bf", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3943aec3-5082-463d-ace3-0e48dde07d51", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5825459c-1b0a-415f-bb63-5fee181cd424", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4136922-5a6e-430f-9499-d1b7bae61bab", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f2cda07a-1fae-4061-8572-bb4465c7ef89", "name": "Rotate the signing secret", "request": { "name": "Rotate the signing secret", "description": { "content": "Returns a new `whsec_` secret, shown only in this response. Effective immediately — verify against both secrets during your rollout, then drop the old.", "type": "text/plain" }, "url": { "path": [ "webhooks", ":webhook_id", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id", "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": [], "auth": null }, "response": [ { "id": "4fe9e7c5-86ed-4141-b240-7eadb23d5d8f", "name": "The new secret.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"secret\": \"whsec_8c2f5e9a1b4d7c0e3f6a9b2c5d8e1f40\",\n \"rotated_at\": \"2026-07-11T14:20:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3cf12d4-37da-4d9a-b989-5be0b9e4e15b", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b3c1906-009f-4173-8749-634852ff9631", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "852dd7a3-dc8c-4155-9a84-e653226079dc", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8ddb3c3-71e4-4b56-9950-3a3ab7bbe98c", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3107489d-e400-43de-94aa-2c8e1928677b", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57fc4b8b-00c9-4b65-bf15-c77ea8aad778", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "rotate-secret" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "34010e5f-1a10-4292-bb0c-92903cd5ca13", "name": "Test-fire a signed fixture event", "request": { "name": "Test-fire a signed fixture event", "description": { "content": "Sends a **fully signed** canned fixture of the chosen event type (default\n`order.paid`) to the endpoint, with envelope flag `\"test_fire\": true`, synchronously,\nand returns the result. Test-fires do not affect `consecutive_failures`. Available in\nboth live and sandbox. Rate class `test` (6/min).\n", "type": "text/plain" }, "url": { "path": [ "webhooks", ":webhook_id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id", "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event\": \"order.paid\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "0da89df4-5db3-4d22-bddc-4d9d8887a342", "name": "Synchronous delivery result.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event\": \"order.paid\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"delivery_id\": \"01JZY3B2N6Q8S0V2X4Z6B8D0F2\",\n \"event_type\": \"order.paid\",\n \"response_status\": 200,\n \"duration_ms\": 187,\n \"succeeded\": true\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "705250f1-c708-4eeb-89bd-87bb74200238", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event\": \"order.paid\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "74aea5e0-1c19-4498-b750-e25d2dc90957", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event\": \"order.paid\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "74c0ba0b-ad67-41ee-8695-783a7154a209", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event\": \"order.paid\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "050bf2b7-901e-4d82-91b7-6a5973c2b0b1", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event\": \"order.paid\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b4984de-acc0-496d-97f2-686c0c26ff89", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event\": \"order.paid\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7a8cba6-ec2c-4639-8e6e-698e4d689933", "name": "`validation_failed` — field-level validation; the `errors` map contains field → messages.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event\": \"order.paid\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#validation_failed\",\n \"title\": \"Validation failed\",\n \"status\": 422,\n \"detail\": \"price.amount must be a positive integer.\",\n \"code\": \"validation_failed\",\n \"errors\": {\n \"price.amount\": [\n \"must be a positive integer\"\n ]\n },\n \"trace_id\": \"req_9f3b2c61a8d44e0f\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20deabdd-8bd7-4709-bcd1-5a7e512e53a1", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event\": \"order.paid\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "766f7ae5-e2ca-4b1e-ba9f-b651d8dd1d51", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "webhooks", ":webhook_id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook endpoint ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "webhook_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event\": \"order.paid\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Webhook deliveries", "description": "Searchable per-attempt delivery log (30-day retention) and resend.", "item": [ { "id": "e9027cd8-a6a2-4e12-af1f-30b2141e42b7", "name": "Search the delivery log", "request": { "name": "Search the delivery log", "description": { "content": "One row per delivery **attempt**. Retention **30 days**. Everything needed to debug without a support ticket.", "type": "text/plain" }, "url": { "path": [ "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "endpoint_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "event_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": " (This can only be one of pending,succeeded,failed)", "type": "text/plain" }, "key": "status", "value": "succeeded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "7960322b-ac94-4d96-8443-b974a3f3dd80", "name": "A page of delivery attempts.", "originalRequest": { "url": { "path": [ "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "endpoint_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "event_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": " (This can only be one of pending,succeeded,failed)", "type": "text/plain" }, "key": "status", "value": "succeeded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"01JZY3B2N6Q8S0V2X4Z6B8D0F2\",\n \"webhook_endpoint_id\": \"01JZW0DC8FGH2JK4MN6PQ8RS0T\",\n \"event_id\": \"01JZY3B1M5P7R9T2V4X6Z8A0C2\",\n \"event_type\": \"order.paid\",\n \"attempt\": 2,\n \"status\": \"failed\",\n \"response_status\": 500,\n \"duration_ms\": 3012,\n \"error\": \"HTTP 500\",\n \"next_attempt_at\": \"2026-07-11T14:09:00Z\",\n \"created_at\": \"2026-07-11T14:04:00Z\"\n }\n ],\n \"next_cursor\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36418342-24a9-4c3a-a22b-4e2fe72a3e9a", "name": "`invalid_json`, `invalid_cursor`, or `idempotency_key_invalid`.", "originalRequest": { "url": { "path": [ "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "endpoint_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "event_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": " (This can only be one of pending,succeeded,failed)", "type": "text/plain" }, "key": "status", "value": "succeeded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#invalid_cursor\",\n \"title\": \"Invalid cursor\",\n \"status\": 400,\n \"detail\": \"This pagination cursor is unknown or has expired; restart without a cursor.\",\n \"code\": \"invalid_cursor\",\n \"trace_id\": \"req_1a2b3c4d5e6f7081\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89085ae9-7b7f-4938-bbe0-20c1374c619e", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "endpoint_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "event_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": " (This can only be one of pending,succeeded,failed)", "type": "text/plain" }, "key": "status", "value": "succeeded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a647669-11a5-4d63-85c4-ba588388c9d9", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "endpoint_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "event_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": " (This can only be one of pending,succeeded,failed)", "type": "text/plain" }, "key": "status", "value": "succeeded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f5195e6-abf1-4c28-885d-b11d85946f24", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "endpoint_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "event_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": " (This can only be one of pending,succeeded,failed)", "type": "text/plain" }, "key": "status", "value": "succeeded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb824c68-f605-4e85-83f1-57349f89fe2b", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "endpoint_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "event_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": " (This can only be one of pending,succeeded,failed)", "type": "text/plain" }, "key": "status", "value": "succeeded" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_after", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_before", "value": "1975-04-30T13:16:23.624Z" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "33fd6ccc-e863-4349-a12c-13db2c239a36", "name": "Delivery attempt detail (with bodies)", "request": { "name": "Delivery attempt detail (with bodies)", "description": { "content": "Additionally returns `request_body` (the exact signed payload) and `response_body` (first 4 KB).", "type": "text/plain" }, "url": { "path": [ "webhook-deliveries", ":delivery_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id", "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "f276a5b3-6d57-45f0-bdf9-5d5856226f91", "name": "The delivery attempt with request/response bodies.", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"id\": \"01JZY3B2N6Q8S0V2X4Z6B8D0F2\",\n \"webhook_endpoint_id\": \"01JZW0DC8FGH2JK4MN6PQ8RS0T\",\n \"event_id\": \"01JZY3B1M5P7R9T2V4X6Z8A0C2\",\n \"event_type\": \"order.paid\",\n \"attempt\": 2,\n \"status\": \"failed\",\n \"response_status\": 500,\n \"duration_ms\": 3012,\n \"error\": \"HTTP 500\",\n \"next_attempt_at\": \"2026-07-11T14:09:00Z\",\n \"created_at\": \"2026-07-11T14:04:00Z\",\n \"request_body\": \"{\\\"id\\\":\\\"01JZY3B1M5P7R9T2V4X6Z8A0C2\\\",\\\"type\\\":\\\"order.paid\\\",…}\",\n \"response_body\": \"{\\\"error\\\":\\\"internal\\\"}\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d41a957f-91a9-462c-9820-c43a416ea626", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "805d0531-a109-480c-a0f5-7f165c1ac358", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32cc97d9-5333-4cc0-8126-209a8a342455", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3d4f40cd-69ae-4f48-9510-c0bc05b20fb1", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "585c44fb-ba84-4296-be94-1800faf72251", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5508b869-f5d1-48c0-906d-cf301b6c9d96", "name": "Re-deliver an event to its endpoint", "request": { "name": "Re-deliver an event to its endpoint", "description": { "content": "Queues a fresh attempt of that delivery's event to its endpoint. Works on succeeded\nor failed deliveries ≤ 30 days old, even if the endpoint's subscription changed.\n", "type": "text/plain" }, "url": { "path": [ "webhook-deliveries", ":delivery_id", "resend" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id", "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": [], "auth": null }, "response": [ { "id": "7d742526-b2de-416a-b224-41af6f784bf0", "name": "Resend queued.", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id", "resend" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"delivery_id\": \"01JZY3B3P7R9T1V3X5Z7B9D1F3\",\n \"status\": \"pending\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "058b0cae-d3d4-4f4a-bb4d-6113d70cb39d", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id", "resend" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6f121ba4-ed45-4ab6-a570-db8a1acdde0a", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id", "resend" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30c1fdc0-55a3-4e44-bf20-77a98737fa58", "name": "`not_found` — no such resource **or not yours** (no existence disclosure).", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id", "resend" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"No such resource.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_deadbeef00112233\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0c82835-f06f-4239-b0d7-903a6fee87ec", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id", "resend" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "77305b5e-4f03-4cc7-adac-369cac24aa38", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id", "resend" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8451342f-ad5d-4b55-b8bf-77121d65dda6", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "webhook-deliveries", ":delivery_id", "resend" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Webhook delivery attempt ULID.", "type": "text/plain" }, "type": "any", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0", "key": "delivery_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Sandbox", "description": "Sandbox-only helpers. Return 404 / not_found on production.", "item": [ { "id": "5bd3c2c7-5359-4e8f-802c-ccf105508c73", "name": "Sandbox only: simulate a buyer order end-to-end", "request": { "name": "Sandbox only: simulate a buyer order end-to-end", "description": { "content": "**Sandbox only** — returns `404` / `not_found` on production. Requires a `ck_test_`\ntoken (any scope). Creates a real order against **your** offer and drives it through\nthe chosen scenario, firing every webhook and — for declared/top-up offers —\n**actually calling your fulfilment endpoints** with real signatures. Bypasses payment\nentirely.\n\n| scenario | Behavior |\n|---|---|\n| `paid` (default) | created → paid → full fulfilment → completed |\n| `payment_failed` | created → payment fails → order cancelled (reservation released) — no `order.paid` |\n| `refund_after_delivery` | full `paid` flow, then ~60 s later a `key_invalid` refund (fires `order.refunded`, calls your return-to-stock) |\n| `dispute_after_delivery` | full `paid` flow, then ~60 s later a `key_invalid` dispute (fires `order.disputed`) |\n\n`form_fields` is required for top-up offers, forbidden otherwise.\n", "type": "text/plain" }, "url": { "path": [ "sandbox", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"quantity\": 1,\n \"buyer_country\": \"FR\",\n \"scenario\": \"paid\",\n \"form_fields\": {\n \"user_id\": \"51231234\",\n \"server_id\": \"2001\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "f5d78370-23b3-4663-bbc1-b59633bc311d", "name": "The simulated order (supplier-scoped order object).", "originalRequest": { "url": { "path": [ "sandbox", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"quantity\": 1,\n \"buyer_country\": \"FR\",\n \"scenario\": \"paid\",\n \"form_fields\": {\n \"user_id\": \"51231234\",\n \"server_id\": \"2001\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replay", "value": "" } ], "body": "{\n \"id\": \"01K00SB0X0000000000000ORD1\",\n \"number\": \"CK-01K00SB0X0000000000000ORD1\",\n \"status\": \"pending\",\n \"buyer_country\": \"FR\",\n \"currency\": \"EUR\",\n \"created_at\": \"2026-07-11T15:00:00Z\",\n \"paid_at\": null,\n \"completed_at\": null,\n \"items\": [\n {\n \"id\": \"01K00SB0X0000000000000ITM1\",\n \"product_id\": \"01JZT4S9GVW2X5YZ7A9BCD3EFG\",\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"external_ref\": \"SKU-STARFORGE-GLOBAL\",\n \"quantity\": 1,\n \"unit_price\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"gross\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"commission\": {\n \"amount\": 170,\n \"currency\": \"EUR\"\n },\n \"net\": {\n \"amount\": 1829,\n \"currency\": \"EUR\"\n },\n \"status\": \"reserved\",\n \"fulfilment\": {\n \"source\": \"declared\",\n \"reservation_id\": \"01K00SB0X0000000000000RSV1\",\n \"inventory_item_ids\": null\n },\n \"delivered_at\": null\n }\n ],\n \"totals\": {\n \"gross\": {\n \"amount\": 1999,\n \"currency\": \"EUR\"\n },\n \"commission\": {\n \"amount\": 170,\n \"currency\": \"EUR\"\n },\n \"net\": {\n \"amount\": 1829,\n \"currency\": \"EUR\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c252eb15-881f-410d-8990-638e45186cec", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "sandbox", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"quantity\": 1,\n \"buyer_country\": \"FR\",\n \"scenario\": \"paid\",\n \"form_fields\": {\n \"user_id\": \"51231234\",\n \"server_id\": \"2001\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99cbd393-3654-4032-ae4a-f73cae7305ed", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "sandbox", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"quantity\": 1,\n \"buyer_country\": \"FR\",\n \"scenario\": \"paid\",\n \"form_fields\": {\n \"user_id\": \"51231234\",\n \"server_id\": \"2001\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb6eb306-4df1-435f-8918-9f0f8c4dd718", "name": "`not_found` — always on production; or the offer is not yours / does not exist.", "originalRequest": { "url": { "path": [ "sandbox", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"quantity\": 1,\n \"buyer_country\": \"FR\",\n \"scenario\": \"paid\",\n \"form_fields\": {\n \"user_id\": \"51231234\",\n \"server_id\": \"2001\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"This endpoint exists only in sandbox.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_e1f2a3b4c5d6e7f8\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc07fb27-bea7-4625-9389-67b4ed0c9822", "name": "`409` conflicts: `offer_exists`, `invalid_state`, `stock_mode_mismatch`, `idempotency_conflict`, or `idempotency_in_flight` (the latter carries `Retry-After: 2`). The operation description lists which apply.", "originalRequest": { "url": { "path": [ "sandbox", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"quantity\": 1,\n \"buyer_country\": \"FR\",\n \"scenario\": \"paid\",\n \"form_fields\": {\n \"user_id\": \"51231234\",\n \"server_id\": \"2001\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#idempotency_conflict\",\n \"title\": \"Idempotency conflict\",\n \"status\": 409,\n \"detail\": \"This Idempotency-Key was already used with a different request body.\",\n \"code\": \"idempotency_conflict\",\n \"trace_id\": \"req_5566778899aabbcc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7037e300-b8a6-4567-97c7-b7bffe61fb54", "name": "`unsupported_media_type` — Content-Type must be application/json.", "originalRequest": { "url": { "path": [ "sandbox", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"quantity\": 1,\n \"buyer_country\": \"FR\",\n \"scenario\": \"paid\",\n \"form_fields\": {\n \"user_id\": \"51231234\",\n \"server_id\": \"2001\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unsupported Media Type", "code": 415, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#unsupported_media_type\",\n \"title\": \"Unsupported media type\",\n \"status\": 415,\n \"detail\": \"Send Content-Type application/json.\",\n \"code\": \"unsupported_media_type\",\n \"trace_id\": \"req_0011223344556677\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9fbe49f7-c8e6-4480-8ba5-01aa981859ed", "name": "`validation_failed` — field-level validation; the `errors` map contains field → messages.", "originalRequest": { "url": { "path": [ "sandbox", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"quantity\": 1,\n \"buyer_country\": \"FR\",\n \"scenario\": \"paid\",\n \"form_fields\": {\n \"user_id\": \"51231234\",\n \"server_id\": \"2001\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#validation_failed\",\n \"title\": \"Validation failed\",\n \"status\": 422,\n \"detail\": \"price.amount must be a positive integer.\",\n \"code\": \"validation_failed\",\n \"errors\": {\n \"price.amount\": [\n \"must be a positive integer\"\n ]\n },\n \"trace_id\": \"req_9f3b2c61a8d44e0f\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b17112e-8972-45b0-997e-c7ede91a0d72", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "sandbox", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"quantity\": 1,\n \"buyer_country\": \"FR\",\n \"scenario\": \"paid\",\n \"form_fields\": {\n \"user_id\": \"51231234\",\n \"server_id\": \"2001\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca624e06-8ad4-48b9-9edb-86754265a0d8", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "sandbox", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Any string, 1–200 chars — a UUID/ULID per logical operation is recommended.\nScope `(token, method, path, key)`, retained 24 h. Replay with identical body\nreturns the original response plus `Idempotent-Replay: true`; a different body is\n`409` / `idempotency_conflict`; a still-running original is\n`409` / `idempotency_in_flight` with `Retry-After: 2`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offer_id\": \"01JZWX5N3PQRS7TV9WXY2Z4A6B\",\n \"quantity\": 1,\n \"buyer_country\": \"FR\",\n \"scenario\": \"paid\",\n \"form_fields\": {\n \"user_id\": \"51231234\",\n \"server_id\": \"2001\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "841f786e-70e9-4b70-bdd9-83a65d83ca2e", "name": "Sandbox only: read the webhook deliveries a sandbox order produced", "request": { "name": "Sandbox only: read the webhook deliveries a sandbox order produced", "description": { "content": "**Sandbox only** — returns `404` / `not_found` on production. Requires a `ck_test_`\ntoken (**any scope** — unlike the real `GET /webhook-deliveries`, which needs the\nmutating `webhooks:manage` scope; the published read-only sandbox token has none).\nLists the delivery attempts for **your own** endpoints, so an integrator can read\nback the signed `order.paid` delivery their `POST /sandbox/orders` call produced.\n\nFilter by `event_type` and by `resource_id` (the sandbox order id) to pinpoint a\nsingle order's delivery. Same `{ data, next_cursor }` keyset envelope and\n`WebhookDelivery` row shape as the real delivery log.\n", "type": "text/plain" }, "url": { "path": [ "sandbox", "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": "The sandbox order id whose delivery you want to read back.", "type": "text/plain" }, "key": "resource_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": [], "auth": null }, "response": [ { "id": "fa787db2-86ff-4a54-9385-495c69603c70", "name": "A page of delivery attempts for your sandbox endpoints.", "originalRequest": { "url": { "path": [ "sandbox", "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": "The sandbox order id whose delivery you want to read back.", "type": "text/plain" }, "key": "resource_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"id\": \"01JZY3B2N6Q8S0V2X4Z6B8D0F2\",\n \"webhook_endpoint_id\": \"01JZW0DC8FGH2JK4MN6PQ8RS0T\",\n \"event_id\": \"01JZY3B1M5P7R9T2V4X6Z8A0C2\",\n \"event_type\": \"order.paid\",\n \"attempt\": 1,\n \"status\": \"succeeded\",\n \"response_status\": 200,\n \"duration_ms\": 42,\n \"error\": null,\n \"next_attempt_at\": null,\n \"created_at\": \"2026-07-11T15:00:01Z\"\n }\n ],\n \"next_cursor\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aae7b1b7-476f-4edd-8203-d1a85d7c78a0", "name": "`invalid_json`, `invalid_cursor`, or `idempotency_key_invalid`.", "originalRequest": { "url": { "path": [ "sandbox", "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": "The sandbox order id whose delivery you want to read back.", "type": "text/plain" }, "key": "resource_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#invalid_cursor\",\n \"title\": \"Invalid cursor\",\n \"status\": 400,\n \"detail\": \"This pagination cursor is unknown or has expired; restart without a cursor.\",\n \"code\": \"invalid_cursor\",\n \"trace_id\": \"req_1a2b3c4d5e6f7081\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "781cabfb-1d13-4dc0-bd8e-0b968c62f522", "name": "`unauthenticated` (missing/malformed header), `invalid_token`, `token_revoked`, or `wrong_environment` (ck_test_ on prod / ck_live_ on sandbox).", "originalRequest": { "url": { "path": [ "sandbox", "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": "The sandbox order id whose delivery you want to read back.", "type": "text/plain" }, "key": "resource_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#wrong_environment\",\n \"title\": \"Wrong environment\",\n \"status\": 401,\n \"detail\": \"This is a ck_test_ token; use {{SANDBOX_BASE_URL}}.\",\n \"code\": \"wrong_environment\",\n \"trace_id\": \"req_90ab12cd34ef5678\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c188f26c-e72f-42c1-9cb8-b480329b884f", "name": "`insufficient_scope` or `supplier_suspended`.", "originalRequest": { "url": { "path": [ "sandbox", "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": "The sandbox order id whose delivery you want to read back.", "type": "text/plain" }, "key": "resource_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#insufficient_scope\",\n \"title\": \"Insufficient scope\",\n \"status\": 403,\n \"detail\": \"This operation requires scope offers:write.\",\n \"code\": \"insufficient_scope\",\n \"trace_id\": \"req_44cc55dd66ee77f0\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "550980fa-58eb-48e5-8f2f-06fbe52a0ccd", "name": "`not_found` — always on production.", "originalRequest": { "url": { "path": [ "sandbox", "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": "The sandbox order id whose delivery you want to read back.", "type": "text/plain" }, "key": "resource_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#not_found\",\n \"title\": \"Not found\",\n \"status\": 404,\n \"detail\": \"This endpoint exists only in sandbox.\",\n \"code\": \"not_found\",\n \"trace_id\": \"req_e1f2a3b4c5d6e7f8\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0dcc0f6c-19d1-4adc-a7b3-2bf71fb421e9", "name": "`rate_limited` — back off per `Retry-After`.", "originalRequest": { "url": { "path": [ "sandbox", "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": "The sandbox order id whose delivery you want to read back.", "type": "text/plain" }, "key": "resource_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#rate_limited\",\n \"title\": \"Rate limited\",\n \"status\": 429,\n \"detail\": \"Write limit (120/min) exceeded for this token.\",\n \"code\": \"rate_limited\",\n \"trace_id\": \"req_7788990011223344\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee066510-8102-4bb6-9882-3def0e3527e7", "name": "`internal_error` — our bug, logged under `trace_id`. Retry with backoff; report if persistent.", "originalRequest": { "url": { "path": [ "sandbox", "webhook-deliveries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of order.created,order.paid,order.expired,order.refunded,order.disputed,offer.deactivated,offer.stock_low,stock.invalidated,webhook.disabled)", "type": "text/plain" }, "key": "event_type", "value": "stock.invalidated" }, { "disabled": false, "description": { "content": "The sandbox order id whose delivery you want to read back.", "type": "text/plain" }, "key": "resource_id", "value": "01JZY2H8K4M6N8P0Q2R4S6T8V0" }, { "disabled": false, "description": { "content": "Opaque cursor from a previous response's `next_cursor`. Expires after 24 h.", "type": "text/plain" }, "key": "cursor", "value": "string" }, { "disabled": false, "description": { "content": "Page size.", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": [] }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"type\": \"https://pay.mmokick.com/developers/errors#internal_error\",\n \"title\": \"Internal error\",\n \"status\": 500,\n \"detail\": \"Something went wrong on our side.\",\n \"code\": \"internal_error\",\n \"trace_id\": \"req_31337cafe0000042\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ], "auth": { "type": "bearer", "bearer": [ { "type": "any", "value": "{{bearerToken}}", "key": "token" } ] }, "event": [], "variable": [ { "key": "baseUrl", "value": "{{SANDBOX_BASE_URL}}", "type": "string", "description": "Active cheap-keys API base URL — starts on the sandbox. Add a bearer token and send. Set this to {{BASE_URL}} to go live." }, { "key": "SANDBOX_BASE_URL", "value": "https://sandbox-pay.mmokick.com/api/v1", "type": "string", "description": "Sandbox API base URL — preconfigured in your download; baseUrl points here by default." }, { "key": "BASE_URL", "value": "https://pay.mmokick.com/api/v1", "type": "string", "description": "Production API base URL — preconfigured in your download; point baseUrl at {{BASE_URL}} to go live." } ], "info": { "_postman_id": "90721ea8-ec26-40dc-a30c-f8172b6d0b05", "name": "cheap-keys Supplier API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "The complete supplier-facing REST API for **cheap-keys**. This document is the\nmachine-readable source of truth for everything the platform hosts and suppliers call.\nThe two contracts *suppliers* host and *we* call are published separately:\n`declared-stock-supplier-contract.yaml` (reservation → order → items fulfilment) and\n`topup-contract.yaml` (validate → execute).\n\n## Authentication\n\n`Authorization: Bearer ` on every request. No other scheme exists. Tokens are\n`ck_live_` (production) or `ck_test_` (sandbox) + 40 random base62 characters, created\nself-service in the supplier portal (2FA required), SHA-256-hashed at rest, **shown once**.\nUp to **25 tokens per environment** per supplier. Tokens never expire; revoke instantly in\nthe portal. Using a `ck_test_` token against production (or `ck_live_` against sandbox)\nreturns `401` / code `wrong_environment` — never a silent fallback.\n\nScopes are assigned at token creation (default: all). A token missing the required scope\ngets `403` / `insufficient_scope`. A request for another supplier's resource returns\n`404` / `not_found` (no existence disclosure). Each operation below declares its required\nscope in `x-required-scope`.\n\nTokens are for server-to-server use only. The API sends no CORS headers; browser use is\nunsupported by design.\n\n## Conventions\n\n- **JSON only.** Requests with a body require `Content-Type: application/json`\n (else `415`). Responses are `application/json; charset=utf-8`; errors are\n `application/problem+json`.\n- **IDs** are ULIDs (26-char Crockford base32). Public order numbers are `CK-` + the\n order ULID. Path parameters take the bare ULID.\n- **Money** is always `{\"amount\": , \"currency\": \"\"}`.\n Supplier API v1 is **EUR-only**; any non-EUR currency in a request is\n `422` / `validation_failed`. Never floats, never strings.\n- **Time** is UTC ISO-8601 with `Z`; field names end `_at`.\n- Every response carries `X-Request-Id` (also embedded in error bodies as `trace_id`).\n- **Body limit** 1 MB (`413` / `payload_too_large`).\n- **Unknown fields in requests are rejected** (`422`). Unknown fields in responses must\n be tolerated by clients — we add fields without a version bump.\n\n## Idempotency\n\nThe `Idempotency-Key` header is honored on all mutating POST endpoints (marked with the\n`Idempotency-Key` parameter below). PUT/PATCH/DELETE are inherently idempotent and do not\nuse the header.\n\n- Key: any string, 1–200 chars. Recommended: a UUID/ULID per logical operation.\n- Scope: `(token, method, path, key)`. Retention: **24 hours**.\n- Replay with same key + identical body → the original response, status included, plus\n header `Idempotent-Replay: true`.\n- Same key + different body → `409` / `idempotency_conflict`.\n- Same key while the first request is still executing → `409` / `idempotency_in_flight`\n with `Retry-After: 2`.\n- `POST /pricing/simulate` is read-only; the header is accepted but ignored there.\n\n## Pagination\n\nCursor-based on every list endpoint: `?limit=` (default 25, max 100) and `?cursor=`\n(opaque string from a previous response). Responses are\n`{\"data\": [...], \"next_cursor\": \"...\"}`; `next_cursor` is `null` on the last page.\nCursors are opaque and expire after 24 h (`400` / `invalid_cursor` after).\n\n## Rate limits (published numbers)\n\nEnforced per token, rolling 60-second windows. Every response from a limiter that ran —\nsuccess or error — carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`,\n`X-RateLimit-Reset` (unix seconds) with the real budget for that window; these are never\nfabricated on an error rejected before any limiter counted it. `429` adds `Retry-After`\nand problem code `rate_limited`. Each operation declares its class in `x-rate-limit-class`:\n\n| Class | Applies to | Limit per token / min |\n|---|---|---|\n| reads | every GET | 600 |\n| writes | mutating endpoints not otherwise classed | 120 |\n| sync | `PUT …/price`, `PUT …/stock` | 300 |\n| bulk | `POST …/inventory` (≤1,000 items each) | 12 |\n| simulate | `POST /pricing/simulate` | 120 |\n| test | webhook test-fire, fulfilment check, sandbox order simulator | 6 |\n\nAdditional ceilings: **1,200 requests/min per supplier** across all its tokens, and\n**30 requests/min per IP** for unauthenticated requests (missing/garbage token), enforced\nbefore token verification; a well-formed bearer token is governed by the per-token limits\ninstead. Limits are identical in sandbox.\nRaises: api@pay.mmokick.com — recorded per supplier and reflected in `GET /whoami`.\n\n## Errors — RFC 9457 problem+json\n\nEvery non-2xx response is `application/problem+json` with a stable machine `code`\n(the field integrations switch on; `title`/`detail` texts may change, codes never do).\n`type` is always `https://pay.mmokick.com/developers/errors#`. The full catalog is\nthe `ErrorCode` schema. Codes are **append-only**: new codes may appear; existing codes\nnever change meaning or HTTP status.\n\n## Versioning\n\nURL major version (`/v1`). Additive changes happen in-place and are recorded in the\nchangelog below (and machine-readably in `x-changelog`). Breaking changes require `/v2`\nwith a 12-month overlap of `/v1`; deprecations are announced via the changelog and a\n`Deprecation: true` + `Sunset: ` header pair on affected endpoints.\n\n## Webhooks\n\nSigned event push to supplier-registered endpoints — see the `webhooks` section of this\ndocument for every event type and payload. Signature scheme (also used for our calls to\nyour fulfilment endpoints):\n\n```\nsigned_payload = + \".\" + \nX-CK-Signature: v1=hex( HMAC-SHA256( secret, signed_payload ) )\n```\n\n`X-CK-Timestamp` is unix **milliseconds**; reject when `|now − timestamp| > 5 minutes`.\nVerify against the raw body with a constant-time comparison. Official test vector:\n\n```\nsecret: whsec_9a41c1f39b6a4f16bd1e2f7c8d3a5e70\ntimestamp: 1767225600000\nbody: {\"hello\":\"cheap-keys\"}\nsigned_payload: 1767225600000.{\"hello\":\"cheap-keys\"}\nsignature: 8f82cbf191ac01a16c7801608cdcf53f4994664db9e5319fc79fea663a444d7a\nheader: X-CK-Signature: v1=8f82cbf191ac01a16c7801608cdcf53f4994664db9e5319fc79fea663a444d7a\n```\n\nDelivery: success = any `2xx` within 10 s. Retry schedule: +0, +1 m, +5 m, +30 m, +2 h,\n+8 h, +24 h (7 attempts). 30 consecutive failed attempts auto-disable the endpoint\n(`webhook.disabled` event + portal alert + email). A `410 Gone` response disables the\nendpoint immediately. Ordering is not guaranteed — dedupe on envelope `id`. Egress IPs\nare not published; authenticate deliveries by signature only.\n\n## Changelog\n\n### 2026-07-11 — 1.0.0\n\n- Initial public release of `/v1`: token introspection, catalog (products, categories),\n machine-readable fee schedule, pricing simulation, offers (uploaded + declared stock\n modes, fast price/stock lanes, fulfilment healthcheck + secret rotation), inventory\n bulk upload/list/invalidate, orders read model, balance + append-only ledger, webhook\n endpoint CRUD + test-fire + delivery log + resend, sandbox order simulator.\n- Published rate-limit classes (reads 600, writes 120, sync 300, bulk 12, simulate 120,\n test 6 per token/min; 1,200/min per supplier).\n- Published error catalog (RFC 9457, stable `code` field) and webhook event catalog\n (order.created, order.paid, order.expired, order.refunded, order.disputed,\n offer.deactivated, offer.stock_low, stock.invalidated, webhook.disabled).\n- Fee schedule v1: commission 850 bps, min fee €0.05/item, no listing / price-change /\n payment / unfulfilled-sale fees, settlement 7 days after delivery.\n\n\nContact Support:\n Name: cheap-keys API support\n Email: api@pay.mmokick.com", "type": "text/plain" } } }