Token.io

token-io Variable Recurring Payments API

These endpoints enable you to initiate Variable Recurring Payments (VRP). Note, that VRP is also available in Payments v2 API.

GitHub OpenAPI

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

POST /vrp-consents Create a VRP consent · Create a VRP consent #
Ask an LLM
“How do I set up a variable recurring payment mandate with a customer?”
“What's needed to create a VRP consent?”
Tell an agent
Create a VRP consent {initiation}.
Set up a variable recurring payment consent with initiation {initiation}.
GET /vrp-consents List VRP consents · Get VRP consents #
Ask an LLM
“Which variable recurring payment consents have I created?”
“Can I filter VRP consents by status or scheme?”
Tell an agent
List {limit} VRP consents with statuses {statuses}.
Show {limit} VRP consents created after {created_after}.
GET /vrp-consents/{id} Get a VRP consent · Get a VRP consent #
Ask an LLM
“What are the limits and status of a VRP consent?”
“Can I look up one VRP consent by id?”
Tell an agent
Get VRP consent {consent_id}.
Show the status of VRP consent {consent_id}.
DELETE /vrp-consents/{id} Revoke a VRP consent · Revoke a VRP consent #
Ask an LLM
“Can I revoke a VRP consent to stop future recurring payments?”
“What happens to a variable recurring payment mandate once revoked?”
Tell an agent destructive · confirm first
Revoke VRP consent {consent_id}.
Cancel the variable recurring payment mandate {consent_id}.
GET /vrp-consents/{id}/payments List payments under a VRP consent · Get payments under a VRP consent #
Ask an LLM
“Which payments have been taken under a VRP consent?”
“Can I page through the payments made on one mandate?”
Tell an agent
List {limit} payments under VRP consent {consent_id}.
Show payments collected on VRP consent {consent_id}, {limit} at a time.
GET /vrps/{id}/confirm-funds Check funds before a VRP payment · Verify if funds are available or not #
Ask an LLM
“Does the payer have enough money before I take a VRP payment?”
“Can I confirm funds for a specific amount under a VRP consent?”
Tell an agent
Confirm funds of {amount} for VRP consent {consent_id}.
Check whether VRP {consent_id} can cover {amount}.

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-variable-recurring-payments-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-variable-recurring-payments-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-variable-recurring-payments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Token.io's Open Banking API for TPPs Variable Recurring…
  description: 'Token.io''s Open Banking API


    Token.io Support: support.token.io


    The Token.io Open Banking API enables you to connect securely with banks for a range of services.'
  version: ''
servers:
- url: https://api.token.io
tags:


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