Partner API

const crypto = require('crypto');

function generateSignature(method, path, body, timestamp, secret) {
  const canonicalString = `${method}\n${path}\n${timestamp}\n${body}`;
  
  return crypto
    .createHmac('sha256', secret)
    .update(canonicalString)
    .digest('hex');
}

// Example
const signature = generateSignature(
  'POST',
  '/api/v1/partner/cashin',
  '{"phone_number":"0771234567","amount":50000,"reference":"PARTNER-TXN-123"}',
  '2026-03-10T12:00:00Z',
  'your_hmac_secret'
);

BODY='{"phone_number":"0771234567","amount":50000,"reference":"PARTNER-TXN-123"}'
TIMESTAMP='2026-03-10T12:00:00Z'
SIGNATURE=$(printf 'POST\n/api/v1/partner/cashin\n%s\n%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$OLIVE_HMAC_SECRET" -hex | sed 's/^.* //')

curl -X POST https://demo.api.vultlocal.com/api/v1/partner/cashin \
  -H "X-API-Key-ID: $OLIVE_API_KEY_ID" \
  -H "X-Partner-ID: $OLIVE_PARTNER_ID" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "Content-Type: application/json" \
  -d "$BODY"

{
  "success": true,
  "transaction_id": "txn_abc123",
  "message": "Cash-in successful",
  "data": {
    "subscriber_id": "sub_xyz789",
    "name": "John Doe",
    "amount": 5000000,
    "new_balance": 7500000,
    "currency": "SLE",
    "reference": "TXN-123456"
  }
}

{
  "success": true,
  "partner_id": "VULT",
  "balance": "15000.00",
  "transactions": [
    {
      "id": "txn_abc123",
      "type": "partner_cashin",
      "status": "completed",
      "amount": "500.00",
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "total_count": 150
}