1. Reference
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Balances & History
      • Get Balances
      • Get Balance History
    • Crypto Deposits
      • Get Crypto Deposit Details
      • Add Travel Rule
    • Crypto Withdrawals
      • Get Whitelisted Wallets
      • Add Whitelisted Wallet
      • Delete Whitelisted Wallet
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
    • SEPA Deposits
      • Get SEPA Payment Details
      • Get SEPA Deposit Details
    • SEPA Withdrawals
      • Create SEPA Withdrawal
      • Get SEPA Withdrawal Details
    • Currency Exchange
      • Get Rates
      • Create Lock
      • Create Exchange
      • Get Exchange Details
  • Integration
    • Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • Crypto Deposit Webhook
      • Crypto Withdrawal Webhook
      • SEPA Deposit Webhook
      • SEPA Withdrawal Webhook
      • Exchange Webhook
  • Reference
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Reference

FAQ

Quick answers to common questions about using the Fintegence Partner API.
This page focuses on the most common onboarding, authentication, deposit, withdrawal, exchange and webhook questions that appear during integration.

General and Authentication#

How do I get API credentials?
To access the Fintegence Partner API, you need to complete the partner onboarding process.
1.
Contact support@fintegence.com and request partner onboarding.
2.
Our team reviews your setup and onboarding details.
3.
After approval, your Business Account is prepared.
4.
You receive:
a staging API key,
a production API key,
a webhook security token.
What is the difference between staging and production?
EnvironmentPurposeFunds
StagingIntegration and testingSome currencies may operate on main blockchain networks - confirm with Support before sending funds
ProductionLive operationsReal funds and transactions
The base URLs are listed in Authentication.
Best practices:
always validate full flows on staging first,
never mix staging keys with production URLs,
keep environment switching configurable in your backend.
Why am I getting 401 or 403?
This usually means there is an API key, environment or IP mismatch.
CodeCause
401 P4001The x-api-key header is missing.
401 P4002The API key is invalid - check for extra spaces or a key from the other environment.
403 P4003In production, the request comes from an IP address that is not whitelisted.
See Authentication and Errors for details.
Does a 201 response mean the transaction succeeded?
No. A 201 response means the request passed validation and the transaction was created. The final outcome is known only when the transaction reaches a final status, for example SUCCESSFUL or REJECTED-BY-REVIEWER.
Always confirm the final state through:
the relevant webhook, or
the matching details endpoint.
See Transaction Processing.

Deposits and Travel Rule#

What is the Travel Rule and when do I need to act?
The Travel Rule requires information about the sender of crypto deposits. When a deposit comes from a sender address that has not been registered, it waits in status WAITING-FOR-TRAVEL-RULE and is not credited.
To release it, register the sender address (fromAddress of the deposit) with Add Travel Rule. All waiting deposits from this address are then processed - credited to the balance or, if they require additional verification, moved to WAITING-FOR-VERIFICATION.
Each address needs to be registered only once. You can also register known sender addresses in advance, so their deposits are not held.
I registered wrong Travel Rule information. Can I change it?
Travel Rule information can be provided only once per address - a second request returns P4305. To correct it, contact support@fintegence.com.
Why is my SEPA deposit waiting for verification?
The first deposit from a new bank account (IBAN) is verified manually by support. After a positive verification, further deposits from the same account are credited automatically. Always send transfers from a bank account held in your company's name, with the exact title from Get SEPA Payment Details.

Withdrawals#

Can I send a crypto withdrawal to any address?
No. Crypto withdrawals can only be sent to addresses on your whitelist. Add the recipient first with Add Whitelisted Wallet, then use the returned id as walletId in Create Crypto Withdrawal. For XRP and TON, include the recipient's memo when adding the address.
Can I send a SEPA withdrawal to any bank account?
No. SEPA withdrawals can only be sent to a bank account held in your company's name. Withdrawals to accounts of other persons or companies are rejected and the funds are returned to the balance.
Can I withdraw my full balance?
Yes. The withdrawal fee is included in amount - the recipient receives amount - fee. If you request the full balance, the recipient receives the balance minus the fee. See Fees.
Why was my withdrawal rejected?
Every withdrawal is reviewed before sending. If it is rejected, it gets status REJECTED-BY-REVIEWER, the reason is sent by email and the full amount including the fee is returned to the balance. If additional information is needed, the status is QUESTIONED and we contact you by email.

Exchange#

What is the difference between Get Rates and Create Lock?
Get Rates is informational. It returns indicative prices of all currencies in EUR.
Create Lock calculates a specific exchange and locks its rate for a short time (currently about 60 seconds, see validUntil). The response contains the exact amounts, including the fee.
Typical pattern:
1.
show an estimate with Get Rates,
2.
request the final quote with Create Lock,
3.
execute it with Create Exchange using the lockId, before the lock expires.
A lock does not reserve funds and can be used only once.
Can I exchange one cryptocurrency for another?
Not directly. Exchanges are supported only between EUR and a cryptocurrency. To convert one cryptocurrency to another, exchange it to EUR first and then from EUR to the target currency. Exchange fees apply to both steps.

Fees#

How should I think about fees?
Fee levels are commercial terms defined in your partnership agreement. The fees that apply to your account are always returned by Get Balances:
crypto and SEPA withdrawals - a fixed fee included in the withdrawal amount,
exchanges - a percentage of the converted amount, charged in the destination currency,
deposits - free.
See Fees for details and examples.

Webhooks and Operational Reliability#

How do I verify webhook authenticity?
Every webhook request includes your shared secret in the Authorization header.
Recommended process:
1.
read the Authorization header,
2.
compare it with your stored webhook secret,
3.
return 401 for missing or invalid values,
4.
only process payloads that pass verification.
What happens if my webhook endpoint fails?
Webhook delivery is retried automatically when your endpoint fails or does not acknowledge the request.
AttemptDelay After Previous Failure
1stInitial delivery
2nd~8 seconds
3rd~16 seconds
4th~32 seconds
5th~64 seconds
Retry is triggered by non-2xx responses or timeouts. Each request times out after approximately 10 seconds.
Your webhook consumer should be idempotent, because the same event may be delivered more than once. If a webhook is not delivered after all attempts, check the status with the details endpoint or Get Balance History.
Previous
Fees
Next
Changelog
Built with