Overview
Before making eSIM purchases, you can check your wallet balance to display it to users or verify sufficient funds are available. The system automatically checks balance during purchase, but displaying it beforehand improves user experience.Quick Start
async function getBalance() {
const response = await fetch('https://api.vellosim.com/api/wallet/balance', {
method: 'GET',
headers: {
'X-API-Key': `API_KEY}`,
'Content-Type': 'application/json'
}
});
const data = await response.json();
return data.balance;
}
// Usage
const balance = await getBalance();
console.log(`Available balance: ${balance.currency} ${balance.amount}`);
import requests
def get_balance():
"""Get wallet balance"""
headers = {
'X-API-Key': f' {API_KEY}',
'Content-Type': 'application/json'
}
response = requests.get(
'https://api.vellosim.com/api/wallet/balance',
headers=headers
)
data = response.json()
return data['balance']
# Usage
balance = get_balance()
print(f"Available balance: {balance['currency']} {balance['amount']}")
<?php
function getBalance() {
$apiKey = 'YOUR_API_KEY';
$ch = curl_init('https://api.vellosim.com/api/wallet/balance');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-Key: ' . $apiKey,
'Content-Type: application/json'
]);
$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);
return $data['balance'];
}
// Usage
$balance = getBalance();
echo "Available balance: {$balance['currency']} {$balance['amount']}";
?>
package main
import (
"encoding/json"
"fmt"
"io"
"net/http"
)
type BalanceResponse struct {
Balance struct {
Amount float64 `json:"amount"`
Currency string `json:"currency"`
} `json:"balance"`
}
func getBalance(apiKey string) (*BalanceResponse, error) {
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://api.vellosim.com/api/wallet/balance", nil)
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")
resp, err := client.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
var result BalanceResponse
json.Unmarshal(body, &result)
return &result, nil
}
func main() {
balance, _ := getBalance("YOUR_API_KEY")
fmt.Printf("Available balance: %s %.2f\n",
balance.Balance.Currency, balance.Balance.Amount)
}
Response Format
{
"balance": {
"amount": 50000.00,
"currency": "NGN"
},
"lastUpdated": "2024-01-15T10:30:00Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
balance.amount | number | Available balance amount |
balance.currency | string | Currency code (e.g., NGN, USD) |
lastUpdated | string | ISO 8601 timestamp of last balance update |
Next Steps
Purchase eSIM
Use wallet balance to purchase eSIM packages
API Reference
Complete API documentation
