Merchant Ledger Entry

# 1. Compute the auth hash: sha256(key|amount|idempotency_key|salt)
API_KEY="YOUR_API_KEY"
API_SALT="YOUR_API_SALT"
AMOUNT="1000.00"
IDEMPOTENCY_KEY="CRM-1"
HASH=$(printf '%s' "$API_KEY|$AMOUNT|$IDEMPOTENCY_KEY|$API_SALT" | openssl dgst -sha256 | awk '{print $2}')

# 2. Call the API (key + hash travel in the request headers)
curl -X POST "https://api.growthbnk.com/v1/route/ledger-entry" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -H "Hash: $HASH" \
  -d '{
    "amount": "'"$AMOUNT"'",
    "idempotency_key": "'"$IDEMPOTENCY_KEY"'",
    "ledger_type": 2,
    "bank_reference_number": "UTR1234567890",
    "remarks": "Cash received through merchant CRM",
    "source": "manual"
  }'

import hashlib
import requests

API_KEY = "YOUR_API_KEY"
API_SALT = "YOUR_API_SALT"
BASE_URL = "https://api.growthbnk.com"

amount = "1000.00"
idempotency_key = "CRM-1"

# Auth hash: sha256(key|amount|idempotency_key|salt)
signing = f"{API_KEY}|{amount}|{idempotency_key}|{API_SALT}"
auth_hash = hashlib.sha256(signing.encode("utf-8")).hexdigest()

payload = {
    "amount": amount,
    "idempotency_key": idempotency_key,
    "ledger_type": 2,               # 1 = Debit, 2 = Credit
    "bank_reference_number": "UTR1234567890",
    "remarks": "Cash received through merchant CRM",
    "source": "manual",
}

response = requests.post(
    f"{BASE_URL}/v1/route/ledger-entry",
    json=payload,
    headers={
        "Content-Type": "application/json",
        "X-API-Key": API_KEY,
        "Hash": auth_hash,
    },
    timeout=30,
)
print(response.status_code, response.json())

<?php
$apiKey  = 'YOUR_API_KEY';
$apiSalt = 'YOUR_API_SALT';
$baseUrl = 'https://api.growthbnk.com';

$amount = '1000.00';
$idempotencyKey = 'CRM-1';

// Auth hash: sha256(key|amount|idempotency_key|salt)
$signing  = "{$apiKey}|{$amount}|{$idempotencyKey}|{$apiSalt}";
$authHash = hash('sha256', $signing);

$payload = [
    'amount'                => $amount,
    'idempotency_key'       => $idempotencyKey,
    'ledger_type'           => 2, // 1 = Debit, 2 = Credit
    'bank_reference_number' => 'UTR1234567890',
    'remarks'               => 'Cash received through merchant CRM',
    'source'                => 'manual',
];

$ch = curl_init("{$baseUrl}/v1/route/ledger-entry");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        "X-API-Key: {$apiKey}",
        "Hash: {$authHash}",
    ],
    CURLOPT_POSTFIELDS     => json_encode($payload),
]);
$response = curl_exec($ch);
echo $response;