Top-up

Fügen Sie einem aktiven Proxy-Paket GB hinzu, bezahlt aus dem Wallet-Guthaben, und prüfen Sie vergangene Aufladungen.

POST /packages/{id}/top-up

Belastet das Wallet-Guthaben und fügt den angeforderten Traffic in vollen GB zum Paket hinzu. Preise nach denselben Volumen-Stufen wie beim ursprünglichen Kauf. Bei Erfolg wächst die Paketquote sofort und Traffic wird beim Upstream-Provider in derselben Anfrage provisioniert.

Bezahlung nur per Wallet

Die Kosten müssen vollständig aus dem Wallet-Guthaben gedeckt sein. Bei zu geringem Guthaben liefert der Endpunkt 402 ohne Seiteneffekte. Für einen neuen Paket-Kauf oder Wallet-Aufladung per Crypto / Stripe nutzen Sie den Web-Checkout. Billing · Buy.

POST/api/v1/packages/{id}/top-up

request.json

{ "quantity_gb": 25 }

response.json

{
  "data": {
    "order_id":            8421,
    "traffic_added_gb":    25,
    "new_quota_gb":        125.0,
    "amount_charged_usd":  42.25,
    "balance_usd":         157.7500
  },
  "meta": { "version": "v1" }
}

402.json

{
  "error": { "code": "payment_required", "message": "Insufficient balance" },
  "meta":  { "version": "v1" }
}

GET /packages/{id}/top-ups

Gibt vorherige Aufladungen für dieses Paket zurück, neueste zuerst. limit und offset zum Paginieren; Defaults 50 und 0.

GET/api/v1/packages/{id}/top-ups?limit=50&offset=0

history.json

{
  "data": {
    "package_id": 12,
    "limit":      50,
    "offset":     0,
    "top_ups": [
      { "order_id": 8421, "traffic_gb": 25.0, "amount_usd": 42.25, "paid_at": "2026-05-29T11:00:00+00:00" },
      { "order_id": 8127, "traffic_gb": 10.0, "amount_usd": 16.90, "paid_at": "2026-05-15T08:32:00+00:00" }
    ]
  },
  "meta": { "version": "v1" }
}

Code-Beispiele

topup.sh

curl -X POST https://raxyproxy.com/api/v1/packages/12/top-up \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{"quantity_gb": 25}'

# History (paginated)
curl "https://raxyproxy.com/api/v1/packages/12/top-ups?limit=20&offset=0" \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

topup.py

import requests, sys

API_KEY    = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
PACKAGE_ID = 12

# Top up by 10 GB; on insufficient balance the call returns 402
r = requests.post(
    f'https://raxyproxy.com/api/v1/packages/{PACKAGE_ID}/top-up',
    headers={'Authorization': f'Bearer {API_KEY}'},
    json={'quantity_gb': 10},
    timeout=15,
)

if r.status_code == 402:
    sys.exit('Wallet balance too low — top up your wallet via the web app first.')

r.raise_for_status()
data = r.json()['data']
print(f"Now {data['new_quota_gb']} GB quota; balance left $${data['balance_usd']:.2f}")