Token.io

token-io Refunds API

These endpoints allow you to handle registration, posting, and retrieval of refunds associated with original transaction account information.

GitHub OpenAPI

Operations 10

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

POST /refunds Refund a payment · Initiate a refund #
Ask an LLM
“How do I refund a customer who paid by bank?”
“Is the debtor account optional when I've registered one for refunds?”
Tell an agent
Initiate a refund {initiation}.
Refund the original transfer using initiation {initiation}.
GET /refunds List refunds · Get refunds #
Ask an LLM
“Which refunds have I issued this month?”
“Can I filter refunds by status or show only partial ones?”
Tell an agent
List {limit} refunds from {start_date} to {end_date}.
Show {limit} refunds with statuses {statuses}.
GET /refunds/{id} Get a refund · Get a refund #
Ask an LLM
“What's the status of a specific refund?”
“Can I look up a refund by its id?”
Tell an agent
Get refund {refund_id}.
Check whether refund {refund_id} has settled.
GET /transfers/{id}/refunds List refunds for a transfer · Get all refunds by transfer #
Ask an LLM
“Which refunds were made against one original payment?”
“Can I see all refunds tied to a transfer id?”
Tell an agent
List {limit} refunds for transfer {transfer_id}.
Show refunds issued against transfer {transfer_id}, {limit} at a time.
POST /refund/registrations Register a debtor account for refund processing · Register a debtor account for refund #
Ask an LLM
“Can I register the account refunds are paid from so I don't pass the debtor each time?”
“Where are extra bank credentials for refunds stored?”
Tell an agent
Register my debtor account for refunds.
Create a refund registration for my debtor account.
GET /refund/registrations/{registrationId} Get refund registration information · Retrieve refund registration information #
Ask an LLM
“What refund registration information do I have on file?”
“Can I retrieve a refund registration by its id?”
Tell an agent
Get refund registration {registration_id}.
Show the debtor account registered under {registration_id}.
DELETE /refund/registrations/{registrationId} Delete refund registration information · Delete refund registration information #
Ask an LLM
“Can I delete a refund registration I set up?”
“What's removed when I delete a refund registration?”
Tell an agent destructive · confirm first
Delete refund registration {registration_id}.
Remove the refund debtor registration {registration_id}.
POST /refunds/signature Build the payload to sign for a refund · Build the payload a merchant has to sign for a refund #
Ask an LLM
“Which payload do I need to sign before submitting a refund?”
“Does generating the refund signing payload create a refund?”
Tell an agent
Build the signing payload for refund initiation {initiation}.
Get the provider payload I must sign for refund {initiation}.
POST /secrets/upload/key-and-certificate Upload a private key and certificate · Upload private key and certificate #
Ask an LLM
“Where do I upload the key and certificate used for refund signing?”
“Can I upload a private key together with its certificate?”
Tell an agent
Upload private key and certificate {upload}.
Store my signing key and certificate {upload}.
GET /refunds/{refundId} Get a refund by refund id (gateway) · Gateway service get refund #
Ask an LLM
“Is there a gateway endpoint to fetch a refund by refundId?”
“Can I read a refund through the gateway service path?”
Tell an agent
Get refund {refund_id} through the gateway service.
Fetch the gateway record for refund {refund_id}.

Documentation

📖
Documentation
https://docs.token.io/products/tpp/api/reference
📖
GettingStarted
https://docs.token.io/products/tpp

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/openapi/token-io-refunds-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-payment-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-vrp-consent-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-account-schema.json

Other Resources

🔗
Reference
https://reference.token.io/
🔗
OpenAPISource
https://docs.token.io/_bundle/products/tpp/api/reference/index.yaml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-ld/token-io-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/token-io:token-io-refunds-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

token-io-refunds-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Token Io Refunds API
  version: '1.0'
  description: 'Operations tagged Refunds across 3 of this provider''s published API definitions: token-io-openapi.yml, token-io-refunds-bnpp-openapi.json, token-io-rest-api-swagger.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.token.io
- url: https://virtserver.swaggerhub.com/token/token-refund-rest-api-bnpp/1.0.2
  description: SwaggerHub API Auto Mocking
- url: https://api.token.io/v2
  description: Token.io API server
- url: https://api.token.io/v1
tags:


# --- truncated at 32 KB (87 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/openapi/token-io-refunds-api-openapi.yml