> ## Documentation Index
> Fetch the complete documentation index at: https://docs.portalhq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Connect your Meld account to Portal to embed the Meld White-Label API for buy and sell crypto through aggregated providers.

## Overview

Portal integrates with [Meld](https://meld.io/) so you can offer buy, sell, and transfer crypto experiences via Meld's [White-Label API](https://docs.meld.io/docs/whitelabel-api-guide) — an aggregated network of fiat-on/off-ramp providers exposed as a single embeddable session.

This page covers one-time setup in the Portal Dashboard and links to the White-Label API workflow guide.

## Steps to enable the Portal Meld integration

### 1. Create your Meld credentials

* Sign up for a Meld account at [dashboard.meld.io](https://dashboard.meld.io/#/sign-up).
* From the Meld Dashboard, generate API keys for the environments you plan to use (sandbox and production are issued separately).

<Note>
  Keep your Meld API keys secure. You will configure them in Portal in the next step.
</Note>

### 2. Enable the Meld integration in Portal

1. Open the [Portal Dashboard](https://app.portalhq.io).
2. Navigate to the `Integrations` page.
3. Locate `Meld` and configure your integration.
4. Paste your Meld API key for the selected Portal environment.
5. Save.

<Frame>
  <img src="https://mintcdn.com/portal-003221ec/sav9TyasF4ywRgDY/images/meld/meld-api-key-card.png?fit=max&auto=format&n=sav9TyasF4ywRgDY&q=85&s=9f52ee165173b5d5e3e9d53167ccf95d" alt="Portal Dashboard Meld configuration modal showing the API Key input" width="2438" height="1434" data-path="images/meld/meld-api-key-card.png" />
</Frame>

<Warning>
  Integrations are environment-scoped. Configure Meld separately for each environment (for example Development and Production), using the matching Meld sandbox or production API key.
</Warning>

### 3. Configure webhooks (optional)

Webhooks are configured directly in Meld Dashboard.

See [Webhooks](/integrations/On-Off-Ramp/meld-webhooks).

## Supported countries, currencies, and assets

Meld's coverage spans dozens of countries, fiat currencies, crypto assets, and chains, and the catalog evolves with provider availability. Rather than hard-coding a list, query the discovery endpoints at runtime to populate dropdowns and validate selections:

* Countries — `GET /clients/me/integrations/meld/discovery/countries`
* Fiat currencies — `GET /clients/me/integrations/meld/discovery/fiat-currencies`
* Crypto currencies — `GET /clients/me/integrations/meld/discovery/crypto-currencies`
* Payment methods — `GET /clients/me/integrations/meld/discovery/payment-methods`
* Service providers — `GET /clients/me/integrations/meld/discovery/service-providers`

See the [White-Label API guide](/integrations/On-Off-Ramp/meld-widget#step-1-discovery) for end-to-end discovery examples.

## Workflow guide

* [White-Label API](/integrations/On-Off-Ramp/meld-widget)
* [Webhooks](/integrations/On-Off-Ramp/meld-webhooks)

## API reference

<Card title="Meld API Reference" icon="arrow-right" href="/api-reference/meld/create-meld-customer">
  Open the interactive Meld endpoints reference.
</Card>

<Tip>
  Cache the discovery responses client-side — countries, currencies, and payment methods change rarely and re-querying on every page load adds unnecessary latency.
</Tip>