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

# Off-Ramp

> Withdraw on-chain crypto rewards into local bank accounts, mobile money, or airtime.

# Off-Ramp

Allows users to cash out their earned tokens into fiat currency or airtime directly to their phone numbers or bank accounts.

***

## Get Off-Ramp Quote

### Endpoint

```http theme={null}
POST /api/v2/payment/off-ramp/quote
```

### Request Body

```json theme={null}
{
  "cryptoAmount": 25.0,
  "cryptoCurrency": "LISK_USDT",
  "fiatCurrency": "KES"
}
```

### Response (200 OK)

```json theme={null}
{
  "success": true,
  "data": {
    "quoteId": "quote-off-1234",
    "cryptoAmount": 25.0,
    "fiatAmount": 3250.0,
    "fiatCurrency": "KES",
    "fee": 0.5,
    "netPayout": 3185.0
  }
}
```

***

## Initialize Off-Ramp

Requires the user's verified wallet PIN or PIN session token.

### Endpoint

```http theme={null}
POST /api/v2/payment/off-ramp/initiate
```

### Headers

```http theme={null}
Authorization: Bearer <jwt_access_token>
```

### Request Body

```json theme={null}
{
  "quoteId": "quote-off-1234",
  "paymentMethod": "MPESA",
  "recipientPhoneNumber": "+254712345678",
  "walletPin": "1234"
}
```

### Response (201 Created)

```json theme={null}
{
  "success": true,
  "data": {
    "orderId": "order-off-5591",
    "status": "PROCESSING",
    "estimatedCompletionMinutes": 5
  },
  "message": "Off-ramp initiated successfully"
}
```