Partner FAQs

Full coverage (fiat currencies, payment methods, fees, and limits) is listed on the coverage page and the global coverage map. Coverage varies by region; users from unsupported regions cannot be processed.

Token listings require a one-time listing fee. The process is:

1. Agree on the listing fee with your account manager.
2. Compliance and due-diligence review (AML, Elliptic coverage checks).
3. Technical integration by Transak’s team.

Once listed, the token is available to all Transak partners. Contact your account manager for a listing proposal.

Certain US states have regulatory restrictions on specific tokens. Use the Get Cryptocurrencies API and filter by state to see which assets are supported in each state.

You can use the Settings page of the Partner dashboard to set the additional partner fee. Enter the desired percentage in FEE PERCENTAGE and click Update.

You can follow https://docs.transak.com/features/webhooks#add-or-update-webhook

No. Authentication and sensitive endpoints must be called from backend only to avoid CORS issues and protect API keys.

Submit the additional domain for whitelisting; domain must match exactly with referrerDomain used during session generation.

The “Invalid or Expired Session” error occurs when the same widgetUrl having same sessionId is reused or reopened after it has already been consumed or expired.

Since each sessionId is single-use, once the widget flow is completed, closed, or expires, the same widgetUrl cannot be used again. A new sessionId must be generated for every new user flow.

The standard flow is:

1. Backend → POST /partners/api/v2/refresh-token  →  access token
2. Backend → POST /api/v2/auth/session            →  widget URL
3. Frontend → load widget URL in iframe / WebView / redirect

See Refresh Access Token and Create Widget URL.

Call the session API once per user session from your backend to generate a widget URL. Calling it repeatedly can consume the one-time token (OTT), causing subsequent loads to fail.

Best practice:

• Store the access token in a server-side cache (e.g. Redis) with a TTL.
• Only refresh the token when the cached one has expired (the expiry time is returned in the API response; the token is valid for 7 days).
• Never call the session or refresh-token endpoints from the frontend.

The OTT stays valid for its full 5-minute lifetime, allowing user retries within that window.

This means requests are being blocked at Transak’s Cloudflare layer. Verify your API key is correct and active. If the issue persists, contact Transak support with your API key and source IP for investigation and potential IP whitelisting.

Log in to the Partner Dashboard with your registered email. The dashboard lets you view order data, monitor volumes, and manage your partner details.

Check that you are passing the API key in the parameters. Some parameters can only be used by partners that have had their KYB approved.

You can find out more details about our ❓ Query Parameters.

To submit your KYB use the below link to verify your business and enable your API key for Production. https://forms.transak.com/kyb

You can use our Get Price API for getting price.

These parameters are required to get response from the API.

"fiatCurrency" //eg: EUR
"cryptoCurrency" //eg: HIVE
"paymentMethod" //eg:sepa_bank_transfer
"partnerApiKey" //YOUR_API_KEY
"network" //mainnet 
"isBuyOrSell" //BUY
"fiatAmount" / "cryptoAmount" //Any one is required

No, currently we are not supporting that feature.

You can use TRANSAK_WIDGET_CLOSE event name.

You can find more about events here.

No, but you can hide the menu option using the query parameters, then the chat will also be disabled.

No, we are not offering such API as of now.

You can use disableWalletAddressForm in our query parameters to achieve this.

You will need to pass the walletAddress. Then if disableWalletAddressForm is set to true then the wallet address screen will be skipped for the user.

Yeah you can pass meta data using partnerCustomerId & partnerOrderId and please refer Webhooks to know more about web-hooks.

Please refer to our documentation about our integration ​here.

Update your backend to call POST /api/v2/auth/session to generate the widget URL, then load the resulting URL in an iframe, WebView, or redirect. Follow the Migration guide.

Yes, both are supported (subject to device and browser compatibility). Partners can enable or disable Apple Pay and Google Pay using the disablePaymentMethod query parameter when generating the widget URL.

Verify that hideMenu: true is correctly included in the widget parameters payload. If the issue persists, share the full widget payload (API key redacted) and a screen recording with Transak support so the team can reproduce the behaviour.

When their KYC is approved they only need to log into their Transak account to perform future transactions. They can use the same KYC-approved Transak account with all of our partner integrations.

Yes, we do support this feature. Please refer KYC Reliance for more details.

Please refer Onboarding and Integration Process Overview.

If two websites are with same company then you can integrate with same API_KEY.

Otherwise you need to submit KYB for each company.

No it is not required in staging. You can use our Sandbox Credentials in staging.

As of now we support only English to communicate.

Gradually we will add other languages as well.

Users must resolve the existing order first (cancel or complete payment). This prevents duplicate or conflicting transactions.

1. Complete the Integration Checklist.
2. Submit KYB via kyb@transak.com.
3. Set up your staging API key for testing.

Production access is enabled after KYB approval. See What is Transak to get oriented.

Transak provides a staging environment for testing, but staging does not enforce all the same constraints as production (some risk rules and KYC thresholds differ). Use the Sandbox Credentials to test in staging.

Full KYC level details and limits are at transak.com/kyc. Limits vary by country and payment method, and are daily rather than lifetime.

Fraud rejections are driven by Transak’s internal risk policies, not by your integration. Partners cannot override risk decisions directly; Transak’s risk team reviews cases individually. To investigate, share the affected user email IDs or order IDs with Transak support.

We create a virtual bank account for each user and currency. So if a Transak user has only made GBP transactions they will be asked to transfer funds each time to a bank account that is unique to them. Any funds that are sent to that unique account are reconciled with transactions made by that user.

If the user transfers funds in multiple currencies they will be assigned a bank account for each currency.

We create a virtual bank account for every user.

Using that, we track the payment.

Transak is dedicated to being transparent about our pricing and fees. There are four variables that are used to calculate the total amount of cryptocurrency received for the chosen amount of fiat:

1. Partner fee: P
   • A percentage charge applied on the transaction amount on behalf of the partner. This fee is configurable by partners.
2. Transak fee: T
   • A percentage charge applied on the transaction amount on behalf of Transak. This covers the fiat processing costs so is set depending on the chosen payment method: credit/debit card or bank transfer. Our fees are set out ​​here.
3. Network/Exchange fee: N
   • This is the sum of the blockchain transaction fees, or gas, that is paid to make the on-chain transfer of the crypto to the user’s wallet address, plus the withdrawal fee the exchange we are using to provide liquidity. These fees vary by blockchain network and cryptocurrency, as well as changing over time depending on network demand. This fee is set by the market not by us.
4. Exchange rate: R
   • This is the conversion rate from fiat to cryptocurrency. It is calculated by taking an up-to-date quote of the market rate from multiple pricing services and adding a small slippage percentage. The slippage varies by cryptocurrency and is calculated according to the actual rate we are able to get in the market.

To calculate the total amount of cryptocurrency, C, for the specified amount of fiat currency, F, we calculate the total fees, deduct them from the fiat amount then convert the remainder to cryptocurrency at the market rate. The formula for this is as follows:

C =(F - (F x P% + F x T% + N) x R

So in the example screenshot below where the partner fee is 1% and the payment is a SEPA bank transfer, based on the market rates and blockchain transaction fees at the time:

C = (€1000 - (€1000 x 1% + €1000 x 0.99% + €0.59) x 0.0002482224
C = (€1000 - €20.49) x  0.0002482224
C = €979.51 x  0.0002482224
C = 0.24313632

Raise the issue with Transak support with:

• Customer email address
• Order ID or transaction ID
• A brief description of the issue (e.g. “funds debited but not transferred”)

The ops team will investigate. Banking partner delays can sometimes slow fund reversals; Transak will communicate updates as they come in.

GET /partners/api/v2/orders?filter[partnerOrderId]=YOUR_ID

The partnerOrderId must match exactly what was submitted during session creation.

Refunds are handled by the support team. Confirm the refund wallet address with Transak support, and the ops team credits the user.

Verify that fiatAmount, cryptoCurrencyCode, and network in your session payload are correct, and test in staging before pushing to production. If discrepancies persist, share the order ID and session parameters with Transak support.

Transak operates a referral program where partners earn revenue share on referred sub-partners. The referral period is time-limited: once it ends or the referred API key becomes inactive, no further dues are accumulated.

Please refer to our list of Testnets.

Ensure your webhook endpoint returns HTTP 200. Also verify that your server logs are not filtering or rejecting the ORDER_COMPLETED event.

Please reach out to our customer support at https://support.transak.com/en/

We are allowing 40 requests per IP address in every 10 seconds. If you want to increase the limit then please contact us at support.transak.com.

Use the Get Fiat Currencies API. The minimum and maximum limits are returned in the response and should be used to display limits dynamically.

This is only for EU KYC users. Partners must perform an IP-based geography check before loading the flow and restrict non-EEA users. See https://docs.transak.com/features/headless-apple-pay-no-auth-no-kyc#supported-eu-regions

The module does not check whether the user’s device supports Apple Pay. Partners must verify Apple Pay availability on the device before loading the Transak UI SDK.

Transak UI SDK supports React Native only. Web-based integrations are not supported at this time. The package is @transak/ui-components-rn on npm.

No. The Transaction Session, Transaction Process, and Transaction Request Status APIs must be called from the partner backend only. Calls are subject to IP whitelisting so partner needs to share their public egress IPs with Transak to whitelist them.

• POST /api/whitelabel/lookup/get-quote → returns quoteId
• POST /api/v2/transaction-session with quoteId + wallet address → returns sessionId
• Mount <TransakApplePay sessionId={...} /> in your React Native app; the SDK fires onSuccess({ requestId }) after the Apple Pay sheet completes
• POST /api/v2/transaction-session/request/:requestId/process from the backend → returns the full order, including orderId
• Poll GET /api/v2/transaction-session/requests/:requestId until the status reaches a terminal state
• Use GET /api/public/get-order-by-order-id for full order details
• Refer to the docs for the canonical sequence

Yes, we recommend the Whitelabel Lookup APIs for new integrations. The Whitelabel base URL is https://api-gateway-stg.transak.com (staging) / https://api-gateway.transak.com (production).

Yes. Order webhooks fire for No-Auth / No-KYC Headless Apple Pay orders the same as for any other flow. Webhook events are always keyed by orderId, not by sessionId or requestId. See Order Webhooks.

After the Transaction Process API succeeds. The sessionId and requestId exist earlier in the flow but are not surfaced in webhooks.

Pass partnerOrderId in the Get Quote call (/api/whitelabel/lookup/get-quote). It will be echoed back in the webhook payload. If partnerOrderId is not passed at the quote step, it is treated as null and will be omitted from the webhook payload.

You need a sandbox Apple ID enrolled in Apple’s Sandbox Tester program, configured with a France billing address (the Headless Apple Pay flow is region-restricted). Transak whitelists the Apple account on our side and provides the Apple Pay test cards (from Apple’s official list — note that only a subset of the listed cards reliably go through). Step-by-step setup: Apple Pay Sandbox Testing for Partners.

The Whitelabel API lets partners build a fully native, branded on/off-ramp experience using Transak’s backend APIs, with no iframe or Transak-hosted UI. With the widget, Transak serves the UI; with the Whitelabel API, you own the entire front-end and call our APIs for quotes, KYC, payment processing, and order management.

Whitelabel API access requires one of:

• Volume commitment model — commit to a monthly volume minimum (e.g. $1M/month) via a refundable deposit; any shortfall is invoiced monthly. The first 6 months are a ramp-up period and volume is not counted against the commitment.
• One-time integration fee — a flat $10,000 fee with no volume commitment; standard Transak pricing applies and rates improve automatically as volume grows.

Contact sales@transak.com to get started.

Yes. Your existing API key must be specifically whitelisted for whitelabel access. Raise a request by writing to sales@transak.com.

Yes. Production Whitelabel API calls must be made from your backend, not the frontend. IP whitelisting is mandatory. See Mandatory Security Changes.

• General APIs: 40 requests per IP per 10 seconds
• Refresh Token API: 10 requests per 10 minutes

Avoid calling the refresh-token endpoint in quick succession to prevent rate limiting.

On-ramp is fully supported. Off-ramp via the Whitelabel API is not available.

Yes. Partners can add a percentage fee on top of Transak’s base rate, paid out at the end of every month. See Managing partner payouts and configuring partner fees.

The standard flow is:

1. Call /api/v2/auth/login to trigger an OTP to the user’s email.
2. Call /api/v2/auth/verify with the OTP to receive an accessToken.
3. Pass the accessToken in the Authorization header for all subsequent authenticated calls.

Transak returns specific error codes for each authentication failure scenario (e.g. invalid email, OTP expired, internal server error). See the Verify User OTP reference.

Yes. Auth Reliance lets partners bypass Transak’s OTP flow for users already authenticated on your platform: you pass a signed token from your system and Transak trusts that authentication. See Auth Reliance.

Yes. Transak’s KYC Reliance module lets you share existing user KYC data (text fields and documents) via API, regardless of which KYC provider you use, so users aren’t re-KYC’d. See KYC Reliance using API.

Yes. Sumsub KYC token sharing (kycShareToken) is supported. See KYC Reliance using Sumsub. Note:

• US users (who require SSN) still need to submit SSN separately.
• Enhanced KYC is not currently supported via Sumsub token sharing.

The user is identified by the accessToken passed in the Authorization header when calling the KYC Reliance API endpoints.

The /api/v2/kyc/share-token-status endpoint returns these states in sequence: INITIALIZED → IMPORTED → VALIDATED → DONE (success) or FAILED. If you don’t have KYC webhooks enabled, poll this endpoint until you reach DONE or FAILED. See Get KYC Reliance Status.

Yes. KYC webhooks are available only for the Whitelabel API (not the standard widget). Your webhook URL must be whitelisted by Transak. See KYC Webhooks.

Headless Apple Pay lets whitelabel partners natively integrate Apple Pay into their app without showing any Transak UI. The partner handles the full Apple Pay UI and calls Transak’s backend APIs to process the payment. It is available exclusively to Whitelabel API partners.

After KYC completes, the partner renders the confirmation / payment screen natively on their side (e.g. a “Pay with Apple Pay” CTA). This is a native screen built by the partner; Transak does not serve any UI in this step.

Transak returns structured error responses with specific failure reasons (e.g. document mismatch, unsupported document type, incomplete data). Handle these on your side and prompt the user to retry or contact support. See the Headless Apple Pay reference.

Create your pending transaction record when the Transaction Process API responds — that is when the Order ID is first returned. Do not create the record at the session-generation step, as the Order ID is only available after the process call. All webhook events are keyed by Order ID.

Like Headless Apple Pay, Headless Google Pay lets whitelabel partners natively integrate Google Pay into their app without any Transak UI. Partners handle the Google Pay sheet on their side and call Transak’s APIs to process the payment. See Headless Google Pay.

The supported regions for Google Pay are the same as for Headless Apple Pay. Use the Get Fiat Currencies API to get the list of supported countries.

Auth Reliance availability for Google Pay follows the same timeline as for Apple Pay and cards.