{"openapi":"3.1.0","info":{"title":"Maksekeskus (BYOK) API","version":"0.1.0","description":"Maksekeskus (BYOK) lets an AI assistant read your own Maksekeskus data through the Maksekeskus API with a key you supply (MakeCommerce Shop ID (API username)). Read-only: 8 tools (get_payment_methods, list_transactions, get_transaction, get_transaction_statement, list_account_statements, list_fees, list_refunds, get_refund). The BYOK key travels with each request, is used for that one call only...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-maksekeskus.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-maksekeskus/docs"},"termsOfService":"https://connectorbay.com/byok-maksekeskus/terms"},"servers":[{"url":"https://byok-maksekeskus.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-maksekeskus/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_payment_methods":{"post":{"operationId":"get_payment_methods","summary":"List the payment methods available to your shop, grouped into banklinks, cards, pay later and other, with country, minim","description":"List the payment methods available to your shop, grouped into banklinks, cards, pay later and other, with country, minimum and maximum amount. Optionally narrow by amount, currency or country. Use for \"Which payment methods can my MakeCommerce shop offer in Estonia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"amount":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only methods available for this amount, for example 25.00.","title":"Amount"},"currency":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Only methods available for this currency, for example EUR.","title":"Currency"},"country":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Only methods available for this country code, for example ee.","title":"Country"},"transaction":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only methods available for this transaction id.","title":"Transaction"}},"title":"get_payment_methodsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_transactions":{"post":{"operationId":"list_transactions","summary":"List the transactions of your shop with status, reference, amount, currency, method, channel, country, fees and net amou","description":"List the transactions of your shop with status, reference, amount, currency, method, channel, country, fees and net amount. Customer, card and bank account details are left out. Filter by created, completed or refunded date and status. Use for \"Which MakeCommerce transactions were completed this month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"since":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions created on or after this Date (2026-01-31) or timestamp.","title":"Since"},"until":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions created before this Date (2026-01-31) or timestamp.","title":"Until"},"completed_since":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions completed on or after this Date (2026-01-31) or timestamp.","title":"Completed Since"},"completed_until":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions completed before this Date (2026-01-31) or timestamp.","title":"Completed Until"},"refunded_since":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions refunded on or after this Date (2026-01-31) or timestamp.","title":"Refunded Since"},"refunded_until":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions refunded before this Date (2026-01-31) or timestamp.","title":"Refunded Until"},"status":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"One or more transaction statuses, for example COMPLETED, CREATED, EXPIRED, CANCELLED, PART_REFUNDED, REFUNDED.","title":"Status"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many entries per page (provider default applies when omitted).","title":"Per Page"}},"title":"list_transactionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_transaction":{"post":{"operationId":"get_transaction","summary":"Get one transaction with status, reference, amount, currency, method, channel, country, fees and net amount. Customer, c","description":"Get one transaction with status, reference, amount, currency, method, channel, country, fees and net amount. Customer, card and bank account details are left out. Use for \"What is the status of MakeCommerce transaction 4766664e-bbab-4775-9e97-13617e785e06\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"transaction_id":{"description":"Transaction id (UUID) from list_transactions.","maxLength":200,"title":"Transaction Id","type":"string"}},"required":["transaction_id"],"title":"get_transactionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_transaction_statement":{"post":{"operationId":"get_transaction_statement","summary":"Get the account statement lines of one transaction: payment, fee and refund movements with amount, original amount and e","description":"Get the account statement lines of one transaction: payment, fee and refund movements with amount, original amount and exchange rate. Use for \"Show the fees booked for MakeCommerce transaction 4766664e-bbab-4775-9e97-13617e785e06\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"transaction_id":{"description":"Transaction id (UUID) from list_transactions.","maxLength":200,"title":"Transaction Id","type":"string"}},"required":["transaction_id"],"title":"get_transaction_statementArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_account_statements":{"post":{"operationId":"list_account_statements","summary":"List the movements of your MakeCommerce merchant account: payments, fees, refunds and payouts with amount, balance befor","description":"List the movements of your MakeCommerce merchant account: payments, fees, refunds and payouts with amount, balance before and after, and payout id. Either since or payout_id is required. Use for \"What payouts and fees hit my MakeCommerce account last month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"since":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Statements from this moment. Required unless payout_id is given. Date (2026-01-31) or timestamp.","title":"Since"},"payout_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only statements belonging to this payout. Required unless since is given.","title":"Payout Id"},"until":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Statements until this moment. Date (2026-01-31) or timestamp.","title":"Until"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many entries per page (provider default applies when omitted).","title":"Per Page"}},"title":"list_account_statementsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_fees":{"post":{"operationId":"list_fees","summary":"List the accounting records of your shop that are not tied to a transaction, such as monthly service fees, with amount a","description":"List the accounting records of your shop that are not tied to a transaction, such as monthly service fees, with amount and VAT. Use for \"What monthly service fees did MakeCommerce charge me this year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"since":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Fees from this date Date (2026-01-31) or timestamp.","title":"Since"},"until":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Fees until this date Date (2026-01-31) or timestamp.","title":"Until"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many entries per page (provider default applies when omitted).","title":"Per Page"}},"title":"list_feesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_refunds":{"post":{"operationId":"list_refunds","summary":"List the refunds of your shop with status, amount, currency, comment and the id and reference of the refunded transactio","description":"List the refunds of your shop with status, amount, currency, comment and the id and reference of the refunded transaction. Customer details are left out. Use for \"Which MakeCommerce refunds were issued last week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"since":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only refunds created on or after this Date (2026-01-31) or timestamp.","title":"Since"},"until":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only refunds created before this Date (2026-01-31) or timestamp.","title":"Until"},"status":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"One or more refund statuses, for example CREATED or SETTLED.","title":"Status"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many entries per page (provider default applies when omitted).","title":"Per Page"}},"title":"list_refundsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_refund":{"post":{"operationId":"get_refund","summary":"Get one refund with status, amount, currency, comment and the id and reference of the refunded transaction. Use for \"Wha","description":"Get one refund with status, amount, currency, comment and the id and reference of the refunded transaction. Use for \"What is the status of MakeCommerce refund 51235\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"refund_id":{"description":"Refund id from list_refunds.","maxLength":200,"title":"Refund Id","type":"string"}},"required":["refund_id"],"title":"get_refundArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}