Skip to main content

​
Welcome to Fin.com API

API Reference

Explore our complete API documentation with detailed endpoints, request/response examples, and authentication guides.

​
API Base URLs

  • Sandbox: https://sandbox.api.fin.com
  • Production: https://api.fin.com

​
Key Concepts

Understanding these core concepts will help you integrate with the Fin.com API effectively:

​
Authentication

The API uses OAuth 2.0 client credentials flow with an enhanced token refresh mechanism. Authenticate securely using your client credentials to obtain access tokens, with the ability to refresh them without re-authentication. All API requests require a valid access token to ensure the security of your transactions and data.

​
Customers

Customers represent the profiles used to initiate transactions within the system. When processing transactions, your customers are the entities that send funds to beneficiaries. Each customer can have multiple beneficiaries associated with their profile.

​
Beneficiaries

A beneficiary is a recipient to whom your customers send funds. Beneficiaries are linked to specific customers, and each customer can maintain multiple beneficiaries for recurring or varied transactions.

​
Catalogue

Pre-defined data provided by Fin.com to facilitate various operations within the API. The catalogue includes reference data, supported countries, currencies, and other essential information needed to execute API actions.

​
Exchange Rates

Real-time and historical exchange rates for currency conversions. Access up-to-date rates to calculate the cost of sending funds from one currency to another.