Skip to main content

​
Financial Operations

Complete API reference for post-activation financial operations including wallet management, beneficiaries, transfers, and payments.
Base URL: https://sandbox.finhub.cloud/api/v2.1/fintrans
For complete details on authentication and headers, refer to the Standard HTTP Headers reference documentation.

​
Prerequisites

Before accessing financial operations:
  • Customer account ACTIVATED (individual or organization)
  • Wallet status = ACTIVE
  • Valid JWT token from session
  • Sufficient wallet balance (for outgoing transfers)
Activation Required: All financial operations require account activation. Attempting to access before activation returns 404 or 422 errors.

​
Core journey (happy path)

StepAPIPurpose
1GET /fintrans/{accountId}/balanceConfirm available funds
2POST /fintrans/{accountId}/beneficiariesRegister a recipient
3POST /fintrans/{accountId}/payment-consents/types/{operationType}Create authorization (if required)
4POST /fintrans/{accountId}/types/{operationType}/prepareValidate and reserve funds
5POST /fintrans/{accountId}/types/{operationType}/executeExecute the prepared operation
6GET /fintrans/{accountId}/orders/{orderId}Monitor status

​
Endpoints

​
Beneficiaries

Add beneficiary (account)

POST /api/v2.1/fintrans/{accountId}/beneficiaries

Get beneficiaries for wallet

POST /api/v2.1/wallets/{walletId}/beneficiaries

​
Account information

Get wallets by customer

GET /api/v2.1/wallets/customer/{customerId}

​
Payment consents

Create payment consent

POST /api/v2.1/fintrans/{accountId}/payment-consents/types/{operationType}

​
Prepare / execute

Prepare financial operation

POST /api/v2.1/fintrans/{accountId}/types/{operationType}/prepare

Execute prepared operation

POST /api/v2.1/fintrans/{accountId}/types/{operationType}/execute

Approve consent

POST /api/v2.1/consents/{consentId}/approve