{"openapi":"3.1.0","info":{"title":"Maya (BYOK) API","version":"0.1.0","description":"Maya (BYOK) lets an AI assistant read your own Maya data through the Maya API with a key you supply (Maya secret API key). Read-only: 6 tools (get_payment, get_payment_by_reference, get_payment_status, list_webhooks, get_webhook, get_checkout_customizations). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-maya-ph.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-maya-ph/docs"},"termsOfService":"https://connectorbay.com/byok-maya-ph/terms"},"servers":[{"url":"https://byok-maya-ph.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-maya-ph/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":{"post":{"operationId":"get_payment","summary":"Get one Maya payment by payment id with status, amount, currency, whether it can be voided, refunded or captured, the fu","description":"Get one Maya payment by payment id with status, amount, currency, whether it can be voided, refunded or captured, the funding source type and your request reference number (card numbers and tokens are not returned). Use for \"What is the status of Maya payment e732f996-cb87-4120-b712-166d8183c01d\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"payment_id":{"description":"Maya payment id (UUID) from a checkout result or webhook.","maxLength":200,"title":"Payment Id","type":"string"}},"required":["payment_id"],"title":"get_paymentArguments","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_payment_by_reference":{"post":{"operationId":"get_payment_by_reference","summary":"Find a Maya payment by the request reference number you set when the payment was created. Use for \"Which Maya payment ha","description":"Find a Maya payment by the request reference number you set when the payment was created. Use for \"Which Maya payment has my reference number 1625127550\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"rrn":{"description":"Request reference number (requestReferenceNumber) you supplied for the payment.","maxLength":200,"title":"Rrn","type":"string"}},"required":["rrn"],"title":"get_payment_by_referenceArguments","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_payment_status":{"post":{"operationId":"get_payment_status","summary":"Get only the current status of a Maya payment by id, for example PAYMENT_SUCCESS or PAYMENT_FAILED. Use for \"Did Maya pa","description":"Get only the current status of a Maya payment by id, for example PAYMENT_SUCCESS or PAYMENT_FAILED. Use for \"Did Maya payment e732f996-cb87-4120-b712-166d8183c01d go through\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"payment_id":{"description":"Maya payment id (UUID).","maxLength":200,"title":"Payment Id","type":"string"}},"required":["payment_id"],"title":"get_payment_statusArguments","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_webhooks":{"post":{"operationId":"list_webhooks","summary":"List the payment webhooks registered on the account with event name and callback URL. Use for \"Which Maya payment webhoo","description":"List the payment webhooks registered on the account with event name and callback URL. Use for \"Which Maya payment webhooks do I have registered\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_webhooksArguments","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_webhook":{"post":{"operationId":"get_webhook","summary":"Get one registered payment webhook by id. Use for \"Show Maya webhook 954cd5a7-1316-4ea1-a014-8f848bd87726\".","description":"Get one registered payment webhook by id. Use for \"Show Maya webhook 954cd5a7-1316-4ea1-a014-8f848bd87726\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"webhook_id":{"description":"Webhook id (UUID) from list_webhooks.","maxLength":200,"title":"Webhook Id","type":"string"}},"required":["webhook_id"],"title":"get_webhookArguments","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_checkout_customizations":{"post":{"operationId":"get_checkout_customizations","summary":"Show the Maya Checkout page customization (logo, title, color scheme, redirect timer). Use for \"How is my Maya Checkout ","description":"Show the Maya Checkout page customization (logo, title, color scheme, redirect timer). Use for \"How is my Maya Checkout page customized\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_checkout_customizationsArguments","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}}}}