Tabby

Tabby Payments API

The core of tabby is a payments flow enabling you to handle payments at your webstore.

Documentation GitHub OpenAPI

Business capability

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v2/payments/{id} Look up a payment with its captures and refunds · Retrieve a payment #

Ask an LLM

“What is the current status of a specific Tabby payment?”

“Can I see which captures and refunds have been made on one payment?”

Tell an agent

Retrieve payment {id}.

Show the status, captures and refunds for payment {id}.

PUT /api/v2/payments/{id} Change a payment's order reference ID · Update a payment #

Ask an LLM

“How do I change the order reference number attached to a payment?”

“Which payment statuses allow me to update the reference ID?”

Tell an agent

Update the order reference on payment {id} to {order}.

Set a new reference ID on authorized payment {id}.

POST /api/v2/payments/{id}/captures Capture an authorized payment · Capture a payment #

Ask an LLM

“How do I collect the money for an order once it ships?”

“Can I capture only part of an authorized payment and the rest later?”

Tell an agent

Capture {amount} on payment {id} with reference {reference_id}.

Capture {amount} for shipped items {items} on payment {id}, idempotency key {reference_id}.

POST /api/v2/payments/{id}/refunds Refund a closed payment · Refund a payment #

Ask an LLM

“How do I refund a customer who returned their order?”

“Can I issue a partial refund instead of refunding the whole payment?”

Tell an agent

Refund {amount} on payment {id} with reference {reference_id}.

Refund {amount} of payment {id} for returned items {items} because {reason}, key {reference_id}.

POST /api/v2/payments/{id}/close Close a payment as final · Close a payment #

Ask an LLM

“How do I cancel a whole order so the customer gets back everything they paid?”

“What should I do with the undelivered remainder after a partial capture?”

Tell an agent destructive · confirm first

Close payment {id}.

Close payment {id} without capturing because the order was fully cancelled.

GET /api/v2/payments List my payments · List of all payments #

Ask an LLM

“Which payments have I taken, newest first?”

“Can I filter my payments by creation date or status?”

Tell an agent

List my recent payments.

List payments created between {created_at__gte} and {created_at__lte}.

Tabby Payments API

Operations 6

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification