Uniwire Docs

Appearance

Third-party Integrations ​

This page explains how to set up and configure third-party integrations for your Uniwire SDK.

Wert Integration ​

Wert is a fiat onramp solution that allows users to purchase cryptocurrency with a credit card directly within your payment flow.

Setup Process ​

To enable Wert integration in your Uniwire profile, follow these steps:

1. Get Your Credentials ​

The first step is to obtain your partner ID and API key from Wert. If you don't already have these credentials, please:

If you are integrating NFT checkout, you will also be provided with your sandbox private key which will be used to sign payment requests.

2. Contact Uniwire Support ​

Once you have obtained your Partner ID and API Key from Wert, contact Uniwire support to activate the integration:

  • Email: support@uniwire.com
  • Subject: Wert Integration Activation Request
  • Include:
    • Your Partner ID and API Key from Wert
    • Your Uniwire Account ID
    • Specify which Uniwire profile you want to connect the integration to

Our team will activate the Wert integration in your Uniwire profile, enabling you to use the integrationProvider: 'WE' parameter in your SDK configuration.

3. Domain Whitelisting ​

Important: Before using the Uniwire widget with Wert integration, you must whitelist your domains with Wert.

Why Domain Whitelisting is Required:

  • Wert requires domain whitelisting for security purposes
  • Only whitelisted domains can successfully call the Wert widget
  • This prevents unauthorized usage of your integration credentials

How to Whitelist Domains:

  1. Contact Wert support with your domain list
  2. Include all domains where you plan to use the Uniwire widget:
    • Production domains (e.g., https://yourdomain.com)
    • Development/staging domains (e.g., https://staging.yourdomain.com, http://dev.yourdomain:3000)
    • Any subdomains you plan to use

What to Include in Your Request:

  • Your Partner ID
  • Complete list of domains (including protocol: https:// or http://)
  • Both production and development domains
  • Any subdomains or variations

Domain Whitelisting Required

Without proper domain whitelisting, the Wert widget will not function correctly and may display errors or fail to load entirely.

4. Enable Supported Coins ​

Wert and Uniwire support different cryptocurrencies, and only the overlapping coins can be purchased through this integration. You need to ensure that the supported coins are enabled in your Uniwire profile.

Supported cryptocurrencies include:

  • Bitcoin (BTC)
  • Ethereum (ETH)
  • Binance Coin (BNB)
  • USDC (multiple networks)
  • USDT (multiple networks)
  • Solana (SOL)
  • Polygon (POL)
  • And many more...

For the complete list of supported coins and networks, see the Wert Supported Coins documentation.

Limitations

Only cryptocurrencies that are both supported by Wert and enabled in your Uniwire profile will be available for purchase through the integration.

Sandbox Testing Limitations ​

When testing the integration with Uniwire testnet coins and Wert sandbox credentials, please note the following limitations:

Wert Sandbox Support:

  • Wert sandbox only supports the Test Token (TT) across multiple networks:
    • Amoy, BSC, KuCoin, Base, Arbitrum, Sepolia, opBNB, Puppynet, Solana
  • Test Token is the only ERC-20 token available in sandbox
  • It's a standard ERC-20 token designed for testing smart contract interactions
  • Test Token contracts are deployed at specific addresses for each network

Uniwire Compatibility:

  • Unfortunately, Uniwire does not currently support the Test Token (TT)
  • This means full sandbox integration testing is not currently possible, due to Wert not sending callbacks in sandbox except for the Test Token (TT)

Workaround:

  • For testing purposes, you can use production credentials with small amounts
  • Or test the integration flow using the production environment with minimal test transactions

For more details about Test Token contracts and addresses, see the Wert Sandbox documentation.

5. Configure Your SDK ​

After activation, you can configure your SDK to use Wert integration:

js
UniwireSDK.setup({
    // Required parameters
    account: 'your-account-id',
    profile: 'your-profile-id',
    
    // Wert integration
    integrationProvider: 'WE',
    integrationLabel: 'Buy with Card', // Optional custom label
    
    // Other configuration...
});

Button Configuration ​

You can also configure Wert integration on individual buttons using data attributes:

html
<button 
    class="uniwire-button"
    data-product="My Product"
    data-amount="100"
    data-currency="USD"
    data-integration-provider="WE"
    data-integration-label="Buy Crypto"
    data-integration-only="true">
    Pay with Card
</button>

Integration Features ​

  • Fiat Onramp: Users can purchase cryptocurrency with credit cards
  • Seamless Integration: Native integration within your payment flow
  • Customizable UI: Custom labels and branding options
  • Multiple Currencies: Support for various fiat currencies
  • Secure Processing: PCI-compliant payment processing

Documentation ​

For more detailed information about Wert integration, visit the Wert Documentation.

Future Integrations ​

We are continuously working on adding more third-party integrations. If you have specific requirements or would like to suggest additional providers, please contact us at support@uniwire.com.

Support ​

If you need help with integration setup or have questions about available providers, please contact our support team: