INVOICE

Invoice API Endpoints

Complete documentation for all Invoice related endpoints.

POST

Create Invoice

Create a payment invoice for cryptocurrency transactions.

Endpoint Details

HTTP Request
POST https://0xhost.com/API/invoice
Parameters
Parameter Type Required Description
user_id string Yes User UUID
order_id string Yes Order UUID
currency string Yes Currency code (e.g. EUR)
pay_currency string Yes Payment cryptocurrency (e.g. ETH)
network string Yes Blockchain network (e.g. Ethereum)
Authentication
API Key Required in header
Headers
Header Value Required Description
x-api-key your_api_key_here Yes Your unique API key for authentication
Content-Type application/json Optional Recommended for consistent response handling

Response Fields

Field Type Description
success boolean Indicates if the operation was successful
message string Response message describing the result
data object/array Contains the response data

Success Response

API Response Example
{
    "success": true,
    "transaction": {
        "id": "5763d0d0-ca37-11f0-8cdf-525400792197",
        "success": true
    },
    "message": "Operation completed successfully!",
    "data": {
        "track_id": "110816020",
        "amount": 89.97,
        "currency": "EUR",
        "pay_amount": 0.0358619204,
        "pay_currency": "ETH",
        "network": "Ethereum Network",
        "address": "0x7717324E33798466298275C82711084B452A8179",
        "qr_code": "URL",
        "lifetime": 90,
        "expired_at": 1764105348,
        "order_id": "594948ab-bb26-11f0-8cae-525400792197",
        "date": 1764099948
    }
}

Code Examples

Programming Languages
JavaScript (Fetch API)
async function makeRequest() {
  try {
    const response = await fetch('https://0xhost.com/API/invoice', {
      method: 'POST',
      headers: {
        'x-api-key': 'your_api_key_here',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
          "user_id": "user_id",
          "order_id": "order12345-6789-0123-4567-890123456789",
          "currency": "EUR",
          "pay_currency": "ETH",
          "network": "Ethereum"
      })
    });

    const data = await response.json();
    console.log('Response:', data);
    return data;
  } catch (error) {
    console.error('Error:', error);
  }
}
Python (Requests)
import requests
import json

def make_request(api_key):
    url = 'https://0xhost.com/API/invoice'
    headers = {
        'x-api-key': api_key,
        'Content-Type': 'application/json'
    }
    data = {
        "user_id": "user_id",
        "order_id": "order12345-6789-0123-4567-890123456789",
        "currency": "EUR",
        "pay_currency": "ETH",
        "network": "Ethereum"
    }

    response = requests.POST(
        url,
        headers=headers,
        json=data
    )

    if response.status_code == 200:
        return response.json()
    else:
        print(f'Error: {response.status_code}')
        return None
PHP (cURL)
function makeRequest($apiKey) {
    $url = 'https://0xhost.com/API/invoice';
    $data = {
        "user_id": "user_id",
        "order_id": "order12345-6789-0123-4567-890123456789",
        "currency": "EUR",
        "pay_currency": "ETH",
        "network": "Ethereum"
    };

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'x-api-key: ' . $apiKey,
        'Content-Type: application/json'
    ]);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    return json_decode($response, true);
}
cURL Command
curl -X POST \
  'https://0xhost.com/API/invoice' \
  -H 'x-api-key: your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{    "user_id": "user_id",    "order_id": "order12345-6789-0123-4567-890123456789",    "currency": "EUR",    "pay_currency": "ETH",    "network": "Ethereum"}'