> For the complete documentation index, see [llms.txt](https://docs.calypso.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.calypso.money/acquiring/customers/how-to-fund-a-customer-address-via-onramp.md).

# How to fund a Customer address via ONRAMP

#### ONRAMP — Cryptocurrency deposits via fiat payments

The ONRAMP service allows you to top up your customers' cryptocurrency addresses using fiat funds. Customers pay with a bank card or other available payment methods, and the selected cryptocurrency is credited to the specified address.

**How it works:**

* The customer selects the cryptocurrency and deposit amount
* Pays in fiat currency using a card or alternative payment method
* Cryptocurrency is deposited to the customer's address

**Features:**

* Buy cryptocurrency with a deposit to the specified address and payment in fiat
* Support for bank cards and other payment methods
* Direct cryptocurrency deposit to the customer's address
* Easy integration via API or widget

### Integration Requirements

To connect the service, the following preliminary steps must be completed:

**1. Customer service integration**\
You need to implement customer creation and management functionality. This ensures each user making transactions can be properly identified.

**2. Obtain customer cryptocurrency addresses**\
For each cryptocurrency you enable for deposits via ONRAMP, you must request and save the corresponding client address. These addresses will be used to credit the cryptocurrency after a successful fiat payment.

**3. Subscribe to transaction status webhooks**<br>

**⚠️ Important:** Customer addresses must be obtained in advance for all currencies that will be available for your users to purchase.<br>

### Process description

To accept fiat payments with deposit to customer address, follow these steps:<br>

{% stepper %}
{% step %}
**Create a customer -** [**Customer/Create**](https://docs.calypso.money/api-reference/customer-purse-api#post-api-v1-customer-purse-customer-create)

* Register the user in the system to obtain a unique identifier for subsequent operations.
* [**How to create a Customer**](https://docs.calypso.money/acquiring/customers/how-to-create-a-customer)
  {% endstep %}

{% step %}
**Obtain a deposit address for the customer -** [**Address/Get**](https://docs.calypso.money/api-reference/customer-purse-api#post-api-v1-customer-purse-address-get)

* For the selected cryptocurrency, request the address where funds will be credited after successful payment.
* [**How to get a deposit address for a Сustomer**](https://docs.calypso.money/acquiring/customers/how-to-get-a-deposit-address-for-a-sustomer)
  {% endstep %}

{% step %}
**Use ONRAMP to accept fiat payment**

* Pass the payment information to the ONRAMP service: cryptocurrency, customer deposit address like **"external\_address"**
* [**How to create a payment via ONRAMP (API integration)**](https://docs.calypso.money/acquiring/onramp-payments/how-to-create-a-payment-via-onramp)
* [**How to integrate the ONRAMP widget (API Widget integration)**](https://docs.calypso.money/acquiring/onramp-widget/how-to-integrate-the-onramp-widget)
  {% endstep %}

{% step %}
**Receive webhook of deposit**

* After successful payment and conversion, you will receive a webhook notification that the cryptocurrency has been credited to the customer's address.
* [**How to process Customer transactions**](https://docs.calypso.money/acquiring/customers/how-to-process-customer-transactions)
* [**Customer transaction events**](https://docs.calypso.money/acquiring/customers/customers-webhooks)
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.calypso.money/acquiring/customers/how-to-fund-a-customer-address-via-onramp.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.
