# Token.io Refunds API (Payments REST 2.0)

**Canonical:** https://apis.io/apis/token-io/token-io-refunds-bnpp-api/  
**Provider:** Token.io — https://apis.io/providers/token-io/  
**Base URL:** https://api.token.io/v2  
**Documentation:** https://docs.token.io/api-definitions/openapi/external/bnpp-refunds

Token.io Refunds API (Payments REST 2.0) is one of 32 APIs that [Token.io](https://apis.io/providers/token-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Refunds, Payments, and Open Banking. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

A separate first-party Token.io OpenAPI 3.0.0 document (version 1.0.2) covering refund registration, initiation, retrieval and signing, plus certificate upload. Retrieved 2026-09-17 through Token.io's own MCP server at https://docs.token.io/mcp; it names https://api.token.io/v2 as the Token.io API server and support@token.io as its contact.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| POST | `/refund/registrations` | Register a debtor account for refund |
| GET | `/refund/registrations/{registrationId}` | Retrieve refund registration information |
| DELETE | `/refund/registrations/{registrationId}` | Delete refund registration information |
| GET | `/refunds` | Retrieve refunds |
| POST | `/refunds` | Initiate a refund |
| POST | `/refunds/signature` | Build the payload a merchant has to sign for a refund |
| GET | `/refunds/{id}` | Retrieve a Refund |
| GET | `/transfers/{id}/refunds` | Retrieve all refunds by transfer |
| POST | `/secrets/upload/key-and-certificate` | Upload private key and certificate |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/openapi/token-io-refunds-bnpp-openapi.json
- **Documentation** — https://docs.token.io/api-definitions/openapi/external/bnpp-refunds

## Other Token.io APIs (12)

- [Token.io JavaScript SDK](https://apis.io/apis/token-io/javascript-sdk/)
- [Token.io PHP SDK](https://apis.io/apis/token-io/php-sdk/)
- [Token.io C# SDK](https://apis.io/apis/token-io/csharp-sdk/)
- [Token.io Objective-C SDK](https://apis.io/apis/token-io/objc-sdk/)
- [Token.io iOS Webview SDK](https://apis.io/apis/token-io/ios-webview-sdk/)
- [Token.io Android Webview SDK](https://apis.io/apis/token-io/android-webview-sdk/)
- [Merchant Sample (Java)](https://apis.io/apis/token-io/merchant-sample-java/)
- [Merchant Sample (JavaScript)](https://apis.io/apis/token-io/merchant-sample-js/)
- [Bank Sample (Java)](https://apis.io/apis/token-io/bank-sample-java/)
- [Personal Finance Management Sample (Java)](https://apis.io/apis/token-io/pfm-sample-java/)
- [Merchant Integration Workshop](https://apis.io/apis/token-io/merchant-integration-workshop/)
- [token-io Account on File API](https://apis.io/apis/token-io/token-io-account-on-file-api/)

## Tags

Refunds, Payments, Open Banking

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/token-io/token-io-refunds-bnpp-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/token-io/.