# First successful On Ramp

## Your first successful on-ramp

A recommended sequence for your first on-ramp integration test.

### Step 1: Check API health

GET /api/v1/health

Verify the trades service is up before starting.

### Step 2: Get supported resources and exchange pairs

GET /api/v1/partner/supported-resources GET /api/v1/partner/exchange-pairs

Find available fiat/crypto pairs and payment methods for your target market.

### Step 3: Create or identify the end-user

POST /api/v1/partner/users

Register the end-user in Unigox. Use the returned public\_uuid in the next step.

### Step 4: Get an on-ramp price estimate (optional)

POST /api/v1/partner/onramp/estimate

Get indicative pricing before committing to a quote. No user or liquidity reservation required.

### Step 5: Get an on-ramp quote

POST /api/v1/partner/onramp/quote

Pass the end-user's public\_uuid, crypto/fiat currency pair, and amount. The quote is valid for \~60 seconds.

### Step 6: Initiate the order

POST /api/v1/partner/onramp/initiate

Pass the quote\_id. The order is created and matched to a vendor. Save the returned order\_id.

### Step 7: Wait for webhook updates

The order progresses automatically:

created → awaiting\_vendor\_escrow\_funding → awaiting\_fiat\_transfer → fiat\_transfer\_pending → completed

At awaiting\_fiat\_transfer — retrieve vendor payment details via GET /api/v1/partner/orders/{order\_id} and forward them to the end-user so they can send fiat.

### Step 8: Confirm payment sent

POST /api/v1/partner/orders/{order\_id}/confirm-payment-sent

Call this once the end-user has initiated the fiat transfer. The order moves to fiat\_transfer\_pending and the vendor is notified.

### Step 9: Done

Wait for the completed webhook. The USDT is now on the master wallet.

Optional: initiate a cross-chain send-out via bridge-authorization-parameters + authorize-bridge.


---

# 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://developers.unigox.com/tutorials/first-successful-on-ramp.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.