Credit Balance API

{
  "clientId": "CLIENT_001",
  "amount": 100.50,
  "description": "Deposit via bank transfer",
  "reference": "BANK_TXN_123456"
}

{
  "status": "success",
  "message": "Balance credited successfully",
  "data": {
    "userId": 123,
    "clientId": "CLIENT_001",
    "amount": 100.50,
    "type": "credit",
    "transactionId": 456,
    "balance": 1600.50
  }
}

{
  "status": "failed",
  "message": "Validation failed",
  "data": {
    "errors": {
      "clientId": ["The clientId field is required."],
      "amount": ["The amount field is required.", "The amount must be at least 0.01."]
    }
  }
}

{
  "status": "failed",
  "message": "User not found",
  "data": null
}

{
  "status": "error",
  "message": "Invalid signature",
  "data": null
}

{
  "status": "failed",
  "message": "Failed to credit balance",
  "data": {
    "error": "Database connection failed"
  }
}

curl -X POST https://wdcf.xerve.online/api/v1/credit-balance \
  -H "Content-Type: application/json" \
  -H "x-signature: YOUR_SIGNATURE" \
  -H "x-timestamp: 1706802000" \
  -d '{
    "clientId": "CLIENT_001",
    "amount": 100.50,
    "description": "Deposit via bank transfer",
    "reference": "BANK_TXN_123456"
  }'

import axios from 'axios';
// Import your signature generation function (see Overview)
import { generateSignature } from './signature-utils';

const API_BASE_URL = 'https://wdcf.xerve.online';
const CLIENT_SECRET = 'your-secret-key';

interface CreditBalanceData {
  clientId: string;
  amount: number;
  description?: string;
  reference?: string;
}

async function creditBalance(data: CreditBalanceData) {
  const timestamp = Math.floor(Date.now() / 1000);

  // Generate signature (see Overview for implementation)
  const signature = generateSignature({
    method: 'POST',
    path: '/api/v1/credit-balance',
    payload: data,
    secret: CLIENT_SECRET,
    timestamp
  });

  try {
    const response = await axios.post(
      `${API_BASE_URL}/api/v1/credit-balance`,
      data,
      {
        headers: {
          'Content-Type': 'application/json',
          'x-signature': signature,
          'x-timestamp': timestamp.toString()
        }
      }
    );

    console.log('Credited amount:', response.data.data.amount);
    console.log('New balance:', response.data.data.balance);
    console.log('Transaction ID:', response.data.data.transactionId);
    return response.data;
  } catch (error: any) {
    console.error('Error:', error.response?.data || error.message);
    throw error;
  }
}

// Usage
creditBalance({
  clientId: 'CLIENT_001',
  amount: 100.50,
  description: 'Deposit via bank transfer',
  reference: 'BANK_TXN_123456'
});

import requests
# Import your signature generation function (see Overview)
from signature_utils import generate_signature
import time

API_BASE_URL = 'https://wdcf.xerve.online'
CLIENT_SECRET = 'your-secret-key'

def credit_balance(client_id: str, amount: float, description: str = None, reference: str = None):
    timestamp = int(time.time())
    payload = {
        "clientId": client_id,
        "amount": amount
    }
    
    if description:
        payload["description"] = description
    if reference:
        payload["reference"] = reference

    # Generate signature (see Overview for implementation)
    signature = generate_signature(
        method="POST",
        path="/api/v1/credit-balance",
        payload=payload,
        secret=CLIENT_SECRET,
        timestamp=timestamp
    )

    headers = {
        "Content-Type": "application/json",
        "x-signature": signature,
        "x-timestamp": str(timestamp)
    }

    response = requests.post(
        f"{API_BASE_URL}/api/v1/credit-balance",
        json=payload,
        headers=headers
    )

    response.raise_for_status()
    data = response.json()
    print(f"Credited amount: {data['data']['amount']}")
    print(f"New balance: {data['data']['balance']}")
    print(f"Transaction ID: {data['data']['transactionId']}")
    return data

# Usage
if __name__ == "__main__":
    credit_balance(
        client_id="CLIENT_001",
        amount=100.50,
        description="Deposit via bank transfer",
        reference="BANK_TXN_123456"
    )