### Get Games

Source: https://github.com/desslyhub/developer-resources/blob/main/README.md

Fetches the full catalog of games with their associated appids.

```APIDOC
## GET /apiv1/steam/games

### Description
Retrieves a list of all available games with their app identifiers.

### Method
GET

### Endpoint
/apiv1/steam/games

### Parameters
None

### Request Example
None

### Response
#### Success Response (200)
- **games** (array) - A list of game objects, each containing `appid` and `name`.

### Response Example
```json
{
  "games": [
    {
      "appid": 12345,
      "name": "Example Game"
    }
  ]
}
```
```

--------------------------------

### Get Available Vouchers

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Returns a list of all available digital vouchers, such as gift cards. Use this to display purchasing options to users.

```bash
curl -X GET "https://api.desslyhub.com/api/v1/vouchers" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Get All Currency Exchange Rates

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Fetches exchange rates for all supported currency pairs in a single API call. This is efficient for displaying multiple currency conversions.

```bash
curl -X GET "https://api.desslyhub.com/api/v1/currency/rates" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Catalog — Get Vouchers

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Returns a list of available digital vouchers (e.g., gift cards) that can be purchased.

```APIDOC
## GET /api/v1/vouchers

### Description
Returns a list of available digital vouchers (e.g., gift cards) that can be purchased.

### Method
GET

### Endpoint
https://api.desslyhub.com/api/v1/vouchers

### Response
#### Success Response (200)
- **vouchers** (array) - A list of available vouchers.
  - **voucher_id** (string) - The unique identifier for the voucher.
  - **name** (string) - The display name of the voucher.
  - **price** (number) - The price of the voucher.
  - **currency** (string) - The currency of the price.
#### Response Example
```json
{
  "vouchers": [
    { "voucher_id": "amazon_usd_10", "name": "Amazon Gift Card $10", "price": 10.00, "currency": "USD" },
    { "voucher_id": "google_play_25", "name": "Google Play $25",      "price": 25.00, "currency": "USD" }
  ]
}
```
```

--------------------------------

### Catalog — Get Mobile Refill Games

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Returns the catalog of mobile games/apps available for refill/top-up.

```APIDOC
## GET /api/v1/mobile/games

### Description
Returns the catalog of mobile games/apps available for refill/top-up.

### Method
GET

### Endpoint
https://api.desslyhub.com/api/v1/mobile/games

### Response
#### Success Response (200)
- **games** (array) - A list of available games.
  - **game_id** (string) - The unique identifier for the game.
  - **name** (string) - The display name of the game.
#### Response Example
```json
{
  "games": [
    { "game_id": "pubg_mobile", "name": "PUBG Mobile" },
    { "game_id": "free_fire",   "name": "Free Fire" }
  ]
}
```
```

--------------------------------

### Get Game by App ID

Source: https://github.com/desslyhub/developer-resources/blob/main/README.md

Retrieves pricing, available regions, and the required package_id for a specific game title using its App ID.

```APIDOC
## GET /apiv1/steam/games/{app_id}

### Description
Fetches detailed information for a specific game, including pricing, supported regions, and the necessary `package_id` for gifting.

### Method
GET

### Endpoint
/apiv1/steam/games/{app_id}

### Parameters
#### Path Parameters
- **app_id** (integer) - Required - The unique application identifier for the game.

### Request Example
None

### Response
#### Success Response (200)
- **package_id** (integer) - The identifier for the game package.
- **price** (object) - Pricing details.
- **regions** (array) - List of available regions.

### Response Example
```json
{
  "package_id": 67890,
  "price": {
    "amount": "19.99",
    "currency": "USD"
  },
  "regions": ["US", "CA"]
}
```
```

--------------------------------

### Authenticate API Requests

Source: https://context7.com/desslyhub/developer-resources/llms.txt

All API requests must include the merchant API key in the Authorization header. This example shows the base URL and header pattern for making requests.

```bash
# All requests use this base URL and header pattern
BASE_URL="https://desslyhub.readme.io"  # canonical docs; actual API host provided by manager

curl -X GET "$BASE_URL/api/v1/steam/games" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

--------------------------------

### Services — Get All Exchange Rates

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Returns exchange rates for all supported currency pairs in a single call.

```APIDOC
## GET /api/v1/currency/rates

### Description
Returns exchange rates for all supported currency pairs in a single call.

### Method
GET

### Endpoint
https://api.desslyhub.com/api/v1/currency/rates

### Response
#### Success Response (200)
- **base** (string) - The base currency for the rates.
- **rates** (object) - An object containing currency pairs and their rates.
  - **currency_code** (number) - The exchange rate for the currency.
- **updated_at** (string) - The timestamp when the rates were last updated.
#### Response Example
```json
{
  "base": "USD",
  "rates": {
    "EUR": 0.92,
    "GBP": 0.79,
    "TRY": 32.10,
    "BRL": 5.05
  },
  "updated_at": "2024-06-01T10:00:00Z"
}
```
```

--------------------------------

### Get Mobile Refill Games Catalog

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Retrieves the catalog of mobile games and apps available for refill or top-up. Use this to populate a selection list for users.

```bash
curl -X GET "https://api.desslyhub.com/api/v1/mobile/games" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### API Error Handling Examples

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Illustrates common API error responses, including insufficient balance, unauthorized access, and transaction not found. These responses include a `code` and `message` field.

```json
# Example: insufficient balance error response (HTTP 402)
# {
#   "code": "INSUFFICIENT_BALANCE",
#   "message": "Your account balance is too low to complete this transaction.",
#   "transaction_id": null
# }
```

```json
# Example: invalid API key (HTTP 401)
# {
#   "code": "UNAUTHORIZED",
#   "message": "Invalid or missing API key."
# }
```

```json
# Example: transaction not found (HTTP 404)
# {
#   "code": "TRANSACTION_NOT_FOUND",
#   "message": "No transaction found with the given ID."
# }
```

--------------------------------

### Send Steam Gift

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Initiate a Steam game gift order to a recipient identified by their Steam 'quick add' friend link. This request returns a transaction ID immediately, with the transaction starting in a 'pending' state. You will need to poll the transaction status endpoint to track its fulfillment.

```bash
curl -X POST "https://api.desslyhub.com/api/v1/steam/gift" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "package_id": "pkg_cs2_us",
    "recipient_steam_link": "https://steamcommunity.com/user/XXXXXXXXXXXXXXX",
    "order_id": "your-internal-order-002"
  }'
```

```bash
# Poll status until resolved
TRANSACTION_ID="txn_def456"
curl -X GET "https://api.desslyhub.com/api/v1/status/$TRANSACTION_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Merchant — Get Balance

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Returns the current merchant account balance, which is used to fund digital goods purchases.

```APIDOC
## Merchant — Get Balance

### Description
Returns the current merchant account balance, which is used to fund digital goods purchases.

### Method
GET

### Endpoint
/api/v1/merchant/balance

### Request Example
```bash
curl -X GET "https://api.desslyhub.com/api/v1/merchant/balance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

### Response
#### Success Response (200)
- **balance** (float) - The current account balance.
- **currency** (string) - The currency of the balance.

#### Response Example
```json
{
  "balance": 1500.00,
  "currency": "USD"
}
```
```

--------------------------------

### Catalog — Send Steam Gift

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Sends a Steam game as a gift to a buyer identified by their Steam "quick add" friend link. Returns a `transaction_id` immediately; the transaction starts in `pending` state.

```APIDOC
## Catalog — Send Steam Gift

### Description
Sends a Steam game as a gift to a buyer identified by their Steam "quick add" friend link. Returns a `transaction_id` immediately; the transaction starts in `pending` state.

### Method
POST

### Endpoint
/api/v1/steam/gift

### Parameters
#### Request Body
- **package_id** (string) - Required - The package ID of the Steam game to gift.
- **recipient_steam_link** (string) - Required - The Steam "quick add" friend link of the recipient.
- **order_id** (string) - Optional - Your internal order identifier.

### Request Example
```bash
curl -X POST "https://api.desslyhub.com/api/v1/steam/gift" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "package_id": "pkg_cs2_us",
    "recipient_steam_link": "https://steamcommunity.com/user/XXXXXXXXXXXXXXX",
    "order_id": "your-internal-order-002"
  }'
```

### Response
#### Success Response (200)
- **transaction_id** (string) - The unique identifier for the transaction.
- **status** (string) - The initial status of the transaction, typically 'pending'.
- **order_id** (string) - Your internal order identifier, if provided.

#### Response Example
```json
{
  "transaction_id": "txn_def456",
  "status": "pending",
  "order_id": "your-internal-order-002"
}
```

### Note
After placing an order, poll the transaction status endpoint using the returned `transaction_id` until the status is resolved.
```

--------------------------------

### Get Transaction Status

Source: https://github.com/desslyhub/developer-resources/blob/main/README.md

Polls for the final status of a transaction using its transaction ID. The status will eventually be 'success' or 'failed'.

```APIDOC
## GET /apiv1/status/{transaction_id}

### Description
Retrieves the current status of a previously initiated transaction. This endpoint should be polled until the transaction reaches a terminal state (success or failed).

### Method
GET

### Endpoint
/apiv1/status/{transaction_id}

### Parameters
#### Path Parameters
- **transaction_id** (string) - Required - The unique identifier of the transaction to check.

### Request Example
None

### Response
#### Success Response (200)
- **status** (string) - The current status of the transaction (e.g., 'pending', 'success', 'failed').
- **order_id** (string) - Optional - Your internal order identifier, if provided during the gift request.

### Response Example
```json
{
  "status": "success",
  "order_id": "YOUR_ORDER_12345"
}
```
```

--------------------------------

### Get Merchant Account Balance

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Retrieve the current merchant account balance. This is used to fund digital goods purchases. The response includes the balance amount and currency.

```bash
curl -X GET "https://api.desslyhub.com/api/v1/merchant/balance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

--------------------------------

### Get Steam Games List

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Retrieve the full Steam games catalog, including app IDs. This is used to discover available titles before placing a gift order. The response is a list of games with their app IDs and names.

```bash
curl -X GET "https://api.desslyhub.com/api/v1/steam/games" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Catalog — Get Steam Games List

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Returns the full Steam games catalog with app IDs, used to discover available titles before placing a gift order.

```APIDOC
## Catalog — Get Steam Games List

### Description
Returns the full Steam games catalog with app IDs, used to discover available titles before placing a gift order.

### Method
GET

### Endpoint
/api/v1/steam/games

### Request Example
```bash
curl -X GET "https://api.desslyhub.com/api/v1/steam/games" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response
#### Success Response (200)
- **games** (array) - A list of available Steam games.
  - **app_id** (integer) - The Steam application ID.
  - **name** (string) - The name of the game.

#### Response Example
```json
{
  "games": [
    { "app_id": 570,   "name": "Dota 2" },
    { "app_id": 730,   "name": "Counter-Strike 2" },
    { "app_id": 1172470, "name": "Apex Legends" }
  ]
}
```
```

--------------------------------

### Get Specific Currency Exchange Rate

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Retrieves the current exchange rate for a specific currency pair (e.g., USD to EUR). Useful for displaying pricing in local currencies.

```bash
curl -X GET "https://api.desslyhub.com/api/v1/currency/rate?from=USD&to=EUR" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Get Steam Game by App ID

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Fetch pricing, available regions, and the required package ID for a specific Steam title. The package ID is necessary when placing a gift order. The response includes details about packages available for the game.

```bash
APP_ID=730  # Counter-Strike 2

curl -X GET "https://api.desslyhub.com/api/v1/steam/games/$APP_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Get Transaction Status

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Poll the status of a specific transaction using its transaction ID. The status transitions from 'pending' to 'success' or 'failed'. This endpoint should be polled after any fulfillment request.

```bash
TRANSACTION_ID="txn_abc123"

curl -X GET "https://api.desslyhub.com/api/v1/status/$TRANSACTION_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Services — Get Currency Exchange Rate

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Returns the current exchange rate for a specific currency pair, used to display pricing in the buyer's local currency.

```APIDOC
## GET /api/v1/currency/rate

### Description
Returns the current exchange rate for a specific currency pair, used to display pricing in the buyer's local currency.

### Method
GET

### Endpoint
https://api.desslyhub.com/api/v1/currency/rate

### Query Parameters
- **from** (string) - Required - The currency to convert from (e.g., USD).
- **to** (string) - Required - The currency to convert to (e.g., EUR).

### Response
#### Success Response (200)
- **from** (string) - The source currency.
- **to** (string) - The target currency.
- **rate** (number) - The exchange rate.
- **updated_at** (string) - The timestamp when the rate was last updated.
#### Response Example
```json
{
  "from": "USD",
  "to": "EUR",
  "rate": 0.92,
  "updated_at": "2024-06-01T10:00:00Z"
}
```
```

--------------------------------

### Catalog — Get Steam Game by App ID

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Returns pricing, available regions, and the required `package_id` for a specific Steam title. The `package_id` is required when placing a gift order.

```APIDOC
## Catalog — Get Steam Game by App ID

### Description
Returns pricing, available regions, and the required `package_id` for a specific Steam title. The `package_id` is required when placing a gift order.

### Method
GET

### Endpoint
/api/v1/steam/games/{app_id}

### Parameters
#### Path Parameters
- **app_id** (integer) - Required - The Steam application ID of the game.

### Request Example
```bash
APP_ID=730  # Counter-Strike 2

curl -X GET "https://api.desslyhub.com/api/v1/steam/games/$APP_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response
#### Success Response (200)
- **app_id** (integer) - The Steam application ID.
- **name** (string) - The name of the game.
- **packages** (array) - A list of available packages for the game.
  - **package_id** (string) - The unique identifier for the package.
  - **region** (string) - The region for which this package is available.
  - **price** (float) - The price of the package.
  - **currency** (string) - The currency of the price.

#### Response Example
```json
{
  "app_id": 730,
  "name": "Counter-Strike 2",
  "packages": [
    {
      "package_id": "pkg_cs2_us",
      "region": "US",
      "price": 0.00,
      "currency": "USD"
    },
    {
      "package_id": "pkg_cs2_eu",
      "region": "EU",
      "price": 0.00,
      "currency": "EUR"
    }
  ]
}
```
```

--------------------------------

### Merchant — Get Transaction Status

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Polls the status of a specific transaction by its `transaction_id`. Status transitions from `pending` → `success` or `failed`. This endpoint should be polled after any fulfillment request.

```APIDOC
## Merchant — Get Transaction Status

### Description
Polls the status of a specific transaction by its `transaction_id`. Status transitions from `pending` → `success` or `failed`. This endpoint should be polled after any fulfillment request.

### Method
GET

### Endpoint
/api/v1/status/{transaction_id}

### Parameters
#### Path Parameters
- **transaction_id** (string) - Required - The unique identifier of the transaction.

### Request Example
```bash
TRANSACTION_ID="txn_abc123"

curl -X GET "https://api.desslyhub.com/api/v1/status/$TRANSACTION_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response
#### Success Response (200)
- **transaction_id** (string) - The unique identifier of the transaction.
- **status** (string) - The status of the transaction ('pending', 'success', 'failed').
- **fulfilled_at** (string) - Optional - Timestamp when the transaction was fulfilled (only present if status is 'success').
- **reason** (string) - Optional - Reason for failure (only present if status is 'failed').

#### Response Example (pending)
```json
{
  "transaction_id": "txn_abc123",
  "status": "pending"
}
```

#### Response Example (success)
```json
{
  "transaction_id": "txn_abc123",
  "status": "success",
  "fulfilled_at": "2024-06-01T12:03:45Z"
}
```

#### Response Example (failed)
```json
{
  "transaction_id": "txn_abc123",
  "status": "failed",
  "reason": "Insufficient balance"
}
```
```

--------------------------------

### Check Steam Login

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Validates a Steam account login before performing a top-up. Use this to prevent failed transactions due to invalid accounts.

```bash
curl -X POST "https://api.desslyhub.com/api/v1/steam/topup/check" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "steam_login": "example_steam_user"
  }'
```

--------------------------------

### Perform Steam Top Up

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Adds wallet credit to a Steam account. Requires a valid `steam_login` verified via the Check Steam Login endpoint.

```bash
curl -X POST "https://api.desslyhub.com/api/v1/steam/topup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "steam_login": "example_steam_user",
    "amount": 20.00,
    "currency": "USD",
    "order_id": "your-internal-order-003"
  }'
```

--------------------------------

### Recommended Polling Pattern with Error Handling (Bash)

Source: https://context7.com/desslyhub/developer-resources/llms.txt

This bash script demonstrates a robust polling mechanism for checking transaction status. It includes a maximum number of attempts and a delay between polls to prevent excessive requests. Ensure you replace 'YOUR_API_KEY' with your actual API key.

```bash
poll_transaction() {
  local txn_id="$1"
  local max_attempts=20
  local attempt=0

  while [ $attempt -lt $max_attempts ]; do
    response=$(curl -s -X GET "https://api.desslyhub.com/api/v1/status/$txn_id" \
      -H "Authorization: Bearer YOUR_API_KEY")

    status=$(echo "$response" | jq -r '.status')

    case "$status" in
      "success")
        echo "Transaction $txn_id succeeded."
        return 0
        ;;
      "failed")
        reason=$(echo "$response" | jq -r '.reason')
        echo "Transaction $txn_id failed: $reason"
        return 1
        ;;
      "pending")
        echo "Still pending... (attempt $((attempt+1)))"
        sleep 5
        ;;
      *)
        echo "Unexpected status: $response"
        return 1
        ;;
    esac

    attempt=$((attempt+1))
  done

  echo "Timed out waiting for transaction $txn_id"
  return 1
}

poll_transaction "txn_abc123"
```

--------------------------------

### Perform Mobile Refill

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Sends a top-up or refill to a mobile game account using a game-specific player ID. Ensure `game_id`, `player_id`, and `package_id` are correct.

```bash
curl -X POST "https://api.desslyhub.com/api/v1/mobile/refill" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "game_id": "pubg_mobile",
    "player_id": "123456789",
    "package_id": "60_uc",
    "order_id": "your-internal-order-004"
  }'
```

--------------------------------

### Buy a Voucher

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Purchases a specific digital voucher by its ID. A `transaction_id` is returned, which can be used to poll for delivery status.

```bash
curl -X POST "https://api.desslyhub.com/api/v1/vouchers/buy" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voucher_id": "amazon_usd_10",
    "order_id": "your-internal-order-005"
  }'
```

--------------------------------

### Catalog — Steam Top Up

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Adds wallet credit to a Steam account. Requires a valid `steam_login` (verified via the Check Steam Login endpoint).

```APIDOC
## POST /api/v1/steam/topup

### Description
Adds wallet credit to a Steam account. Requires a valid `steam_login` (verified via the Check Steam Login endpoint).

### Method
POST

### Endpoint
https://api.desslyhub.com/api/v1/steam/topup

### Request Body
- **steam_login** (string) - Required - The Steam login identifier for the top-up.
- **amount** (number) - Required - The amount of credit to add.
- **currency** (string) - Required - The currency of the amount (e.g., USD).
- **order_id** (string) - Required - A unique identifier for the order.

### Request Example
```json
{
  "steam_login": "example_steam_user",
  "amount": 20.00,
  "currency": "USD",
  "order_id": "your-internal-order-003"
}
```

### Response
#### Success Response (200)
- **transaction_id** (string) - The unique identifier for the transaction.
- **status** (string) - The status of the transaction (e.g., pending).
- **order_id** (string) - The order ID provided in the request.
#### Response Example
```json
{
  "transaction_id": "txn_ghi789",
  "status": "pending",
  "order_id": "your-internal-order-003"
}
```
```

--------------------------------

### Catalog — Check Steam Login

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Validates that a Steam account login/identifier is reachable before performing a top-up, preventing failed transactions due to invalid accounts.

```APIDOC
## POST /api/v1/steam/topup/check

### Description
Validates that a Steam account login/identifier is reachable before performing a top-up, preventing failed transactions due to invalid accounts.

### Method
POST

### Endpoint
https://api.desslyhub.com/api/v1/steam/topup/check

### Request Body
- **steam_login** (string) - Required - The Steam login identifier to check.

### Request Example
```json
{
  "steam_login": "example_steam_user"
}
```

### Response
#### Success Response (200)
- **valid** (boolean) - Indicates if the Steam login is valid.
- **display_name** (string) - The display name of the Steam user, if valid.
#### Response Example
```json
{
  "valid": true,
  "display_name": "Example Steam User"
}
```
#### Error Response Example
```json
{
  "valid": false,
  "reason": "Account not found"
}
```
```

--------------------------------

### List Merchant Transactions

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Fetch a paginated list of all merchant transactions. This endpoint is useful for reconciliation and reporting purposes. The response includes transaction details, page number, and total count.

```bash
curl -X GET "https://api.desslyhub.com/api/v1/merchant/transactions" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Gift Steam Game

Source: https://github.com/desslyhub/developer-resources/blob/main/README.md

Sends a Steam gift to a buyer using their "add as friend" link. This initiates a transaction that will be processed by DesslyHub.

```APIDOC
## POST /apiv1/steam/gift

### Description
Initiates the process of gifting a Steam game to a specified recipient. Upon successful initiation, a transaction ID is returned, and the transaction status can be polled.

### Method
POST

### Endpoint
/apiv1/steam/gift

### Parameters
#### Request Body
- **recipient_friend_link** (string) - Required - The "add as friend" link for the Steam recipient.
- **package_id** (integer) - Required - The package identifier of the game to gift.
- **order_id** (string) - Optional - Your internal order identifier for reconciliation.

### Request Example
```json
{
  "recipient_friend_link": "https://steamcommunity.com/profiles/76561198000000001",
  "package_id": 67890,
  "order_id": "YOUR_ORDER_12345"
}
```

### Response
#### Success Response (200)
- **transaction_id** (string) - The unique identifier for the gift transaction.

### Response Example
```json
{
  "transaction_id": "txn_abc123xyz789"
}
```
```

--------------------------------

### Catalog — Mobile Refill

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Sends a top-up/refill to a mobile game account using a game-specific player ID.

```APIDOC
## POST /api/v1/mobile/refill

### Description
Sends a top-up/refill to a mobile game account using a game-specific player ID.

### Method
POST

### Endpoint
https://api.desslyhub.com/api/v1/mobile/refill

### Request Body
- **game_id** (string) - Required - The ID of the game to refill.
- **player_id** (string) - Required - The player ID within the game.
- **package_id** (string) - Required - The ID of the refill package.
- **order_id** (string) - Required - A unique identifier for the order.

### Request Example
```json
{
  "game_id": "pubg_mobile",
  "player_id": "123456789",
  "package_id": "60_uc",
  "order_id": "your-internal-order-004"
}
```

### Response
#### Success Response (200)
- **transaction_id** (string) - The unique identifier for the transaction.
- **status** (string) - The status of the transaction (e.g., pending).
- **order_id** (string) - The order ID provided in the request.
#### Response Example
```json
{
  "transaction_id": "txn_jkl012",
  "status": "pending",
  "order_id": "your-internal-order-004"
}
```
```

--------------------------------

### Merchant — List Transactions

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Returns a paginated list of all merchant transactions, useful for reconciliation and reporting.

```APIDOC
## Merchant — List Transactions

### Description
Returns a paginated list of all merchant transactions, useful for reconciliation and reporting.

### Method
GET

### Endpoint
/api/v1/merchant/transactions

### Parameters
#### Query Parameters
- **page** (integer) - Optional - The page number to retrieve.

### Request Example
```bash
curl -X GET "https://api.desslyhub.com/api/v1/merchant/transactions" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response
#### Success Response (200)
- **transactions** (array) - A list of transaction objects.
  - **transaction_id** (string) - Unique identifier for the transaction.
  - **order_id** (string) - Merchant's internal order identifier.
  - **type** (string) - The type of transaction (e.g., 'steam_gift').
  - **status** (string) - The status of the transaction ('success', 'failed', 'pending').
  - **amount** (float) - The amount of the transaction.
  - **created_at** (string) - Timestamp when the transaction was created.
- **page** (integer) - The current page number.
- **total** (integer) - The total number of transactions available.

#### Response Example
```json
{
  "transactions": [
    {
      "transaction_id": "txn_abc123",
      "order_id": "your-internal-order-001",
      "type": "steam_gift",
      "status": "success",
      "amount": 29.99,
      "created_at": "2024-06-01T12:00:00Z"
    }
  ],
  "page": 1,
  "total": 42
}
```
```

--------------------------------

### Catalog — Buy Voucher

Source: https://context7.com/desslyhub/developer-resources/llms.txt

Purchases a specific voucher by its ID. Returns a `transaction_id` that can be polled for the voucher code delivery status.

```APIDOC
## POST /api/v1/vouchers/buy

### Description
Purchases a specific voucher by its ID. Returns a `transaction_id` that can be polled for the voucher code delivery status.

### Method
POST

### Endpoint
https://api.desslyhub.com/api/v1/vouchers/buy

### Request Body
- **voucher_id** (string) - Required - The ID of the voucher to purchase.
- **order_id** (string) - Required - A unique identifier for the order.

### Request Example
```json
{
  "voucher_id": "amazon_usd_10",
  "order_id": "your-internal-order-005"
}
```

### Response
#### Success Response (200)
- **transaction_id** (string) - The unique identifier for the transaction.
- **status** (string) - The status of the transaction (e.g., pending).
- **order_id** (string) - The order ID provided in the request.
#### Response Example
```json
{
  "transaction_id": "txn_mno345",
  "status": "pending",
  "order_id": "your-internal-order-005"
}
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.