> For the complete documentation index, see [llms.txt](https://guide.unigox.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.unigox.com/integration-guide/partner-integration-instructions.md).

# Partner Integration Instructions

### Contact our team

For fast support or any questions, you can

* contact our team on the homepage
* email our support <support+integration@unigox.com>
* set up a meeting with our team through [Calendly](https://calendly.com/skyzer-unigox/30min)

### Deep Link Integration

Best for: Fastest launch, minimal development, no compliance headaches.

You create a link to the Unigox widget with prefilled parameters. When the user clicks the button (e.g., "Buy with Bank" or "Sell for Cash"), they are taken to a hosted Unigox page with the trade details already set.

```url
https://www.unigox.com/buy?amount=100&asset=USDC&currency=NGN&paymentMethod=Opay
```

Prefill Parameters

| Parameter     | Required |                                                        |
| ------------- | -------- | ------------------------------------------------------ |
| crypto        | yes      | Asset code (e.g., USDC, USDT)                          |
| fiat          | yes      | Fiat currency code (e.g., NGN, MXN, BRL)               |
| amount        | no       |                                                        |
| side          | yes      | buy or sell                                            |
| paymentMethod |          | Specific method/network if desired (e.g., M-PESA, PIX) |
| partnerId     | no       | Your assigned partner ID for tracking revenue share    |
| redirectUrl   | no       | URL to redirect after trade completion                 |

✅ Fastest way to go live – no development required

### Iframe Widget

Best for: Keeping users inside your flow while using Unigox's infrastructure.

You can embed our widget directly into your site or app. The same parameters as the deep link are supported, but the widget is shown inline.

```html
<iframe
  src="https://www.unigox.com/buy?amount=100&asset=USDT&currency=MXN"
  width="100%"
  height="700"
  style="border:none;">
</iframe>
```

White-labeling is available on request (remove Unigox branding).

### Key Differences: Deep Link vs. Iframe

|                               | Deep Link                | Iframe               |
| ----------------------------- | ------------------------ | -------------------- |
| Integration speed             | Fastest (minutes)        | Quick (minutes)      |
| User stays in your site       | ❌                        | ✅                    |
| Branding control              | Standard Unigox branding | Optional white-label |
| Mobile app friendly           | ✅                        | ✅                    |
| Custom payment method prefill | ✅                        | ✅                    |

### Server-to-Server API

Best for: full backend control over the trade lifecycle — your UI, our liquidity.

The Unigox Partner API gives you programmatic access to:

* **Quotes & liquidity** — real-time rates across all corridors
* **On-ramp orders** — collect local fiat, deliver crypto
* **Off-ramp orders** — accept crypto, pay out to local bank accounts and mobile wallets
* **User management & KYC** — onboard your customers under Unigox compliance
* **Webhooks** — order status updates pushed to your backend

Full API reference, authentication, and sandbox details: [developers.unigox.com](https://developers.unigox.com). SDKs are available for JavaScript, Python, and C#.

To get API credentials, [contact our team](mailto:support+integration@unigox.com).
