1. Internal Transfers
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Balances & Transaction History
        • Get Balances
        • Get Transaction History
        • Create Wallet
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • Get SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Orders
        • Get Rates
        • Retrieve Order Rate and Create a Lock
        • Create and Finalize an Order
        • Get Order Details
      • Payment link & Checkout Link
        • Generate Payment Link
        • Generate Hosted Checkout
        • Get Payment Link Details
    • User Operations
      • Onboarding & KYC Flow
        • Create User Account
        • Method A: Add KYC File
        • Method B: Creating KYC Verification
        • Method B: Redirect to Verification
        • Method B: Get KYC Status
        • Add User Verification
        • Add POA File
      • Account Management
        • Update Existing User
        • Delete User
        • Suspend User
        • Unsuspend User
      • Balances & Transaction History
        • Get User Balances
        • Get User Transaction History
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • GET SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Internal Transfers
        • Create a Transfer
          POST
        • Get Transfer Details
          GET
      • Virtual Cards
        • Create Virtual Card
        • Get All User Cards
        • Get Card Details
        • Update Card PIN
        • Block Card
        • Unblock Card
        • Get Card Limits
        • Update Card Limits
        • Delete Card
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
        • High Risk KYC Verification Webhook
      • Transfers & Payments Webhooks
        • Internal Transfer Webhook
        • IBAN Status Webhook
        • Partner SEPA Transfer Webhook
        • User SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order Status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Internal Transfers

Create a Transfer

Testing Env
https://stage-api.fintegence.io
Testing Env
https://stage-api.fintegence.io
POST
/v1/transfer
This endpoint allows you to initiate a transfer of funds between a specific user and the partner account. The partner balance is always involved in the transaction, acting as either the source or the destination.

Direction Logic#

User to Partner: If sourceExternalUserId is provided, funds are moved from the user's balance to the partner treasury.
Partner to User: If destinationExternalUserId is provided, funds are moved from the partner treasury to the user's balance.

Constraints and Rules#

Asset Support: Currently, only cryptocurrency and stablecoin transfers are supported. Internal transfers for fiat currencies such as EUR are not available at this time.
No User-to-User Transfers: Direct transfers between two different users are not supported. All movements must involve the partner account.
Request Requirement: The request must specify the amount, currency, and at least one of the external user IDs.
Asynchronous Processing
Requests are accepted and scheduled for processing asynchronously. Business logic errors such as insufficient funds or invalid parameters may not be validated at the initial request stage.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/json

Examples

Responses

🟢201Created
application/json
Bodyapplication/json

🟠401Access Denied
🟠400P403: Validation error
🟠404P412: User not exist
🟠400P424: Source or destination must be provided
🟠400P500: Unknown exception
🟠400P501: Service temporarily unavailable
🟠400P459: User not verified
🟠400P472: P2P FIAT not available
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://stage-api.fintegence.io/v1/transfer' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "sourceExternalUserId": "456bd63d-d736-43cf-af8b-775ddf998bef",
    "amount": "5",
    "currency": "eur"
}'
Response Response Example
201 - Example 1
{
    "transferId": "082768b4-c831-47fb-920b-fea0d8d51be0"
}
Previous
Internal Transfers
Next
Get Transfer Details
Built with