# Integration examples

This section assumes that you already have a registered merchant and know how to sign the pay widget URLs.

### On-ramp to a predefined address

Let's say you want a user to pay fiat, and the system must send 10 Polygon USDT to this wallet address: 0x41018795fA95783117242244303fd7e26e964eE8. To do so, you must provide the next URL params:

* source
* signature
* network - POLYGON
* asset - USDT
* address - 0x41018795fA95783117242244303fd7e26e964eE8
* amount - 10
* currency - crypto
* freezeWallet - true, doesn't allow a user to change the wallet address
* freezeAmount - true, doesn't allow a user to change the amount

So the end URL would look like next:

{% code overflow="wrap" %}

```
https://sandbox-pay.fonbnk.com?source=...&signature=...&network=POLYGON&asset=USDT&address=0x41018795fA95783117242244303fd7e26e964eE8&amount=10&currency=crypto&freezeWallet=true&freezeAmount=true
```

{% endcode %}

If a user creates an order using this URL, you will receive webhooks to the configured server endpoint in the merchant dashboard.

### Off-ramp to a specific fiat type

Let's say you want a user to buy 50000 NGN using his Celo CUSD wallet. To do so, you must provide the next URL params:

* source
* signature
* network - CELO
* asset - CUSD
* amount - 50000
* currency - local
* countryIsoCode - NG

So the end URL would look like next:

{% code overflow="wrap" %}

```
https://sandbox-pay.fonbnk.com/offramp?source=...&signature=...&network=CELO&asset=CUSD&amount=50000&currency=local&countryIsoCode=NG
```

{% endcode %}

### On-ramp using a quote

Let's say you're an on-ramp aggregator and want to display our pricing before redirecting a user to our widget, and you want a price to remain unchanged. To do so, you must make an API request to our [create quote endpoint](/server-to-server/api-endpoints/create-quote.md) and use the quoteId from the response as a URL query parameter. Let's say you want a user to convert his M-PESA 1000KES to Tron USDT, you must provide the next URL params:

* source
* signature
* quoteId - quote ID received from the API response
* network - TRON
* asset - USDT
* amount - 1000
* currency - local
* paymentChannel - mobile\_money
* countryIsoCode - NG

So the end URL would look like next:

{% code overflow="wrap" %}

```
https://sandbox-pay.fonbnk.com/offramp?source=...&signature=...&quoteId=...&network=TRON&asset=USDT&amount=1000&currency=local&countryIsoCode=KE&paymentChannel=mobile_money
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fonbnk.com/widget-integration/integration-examples.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.