Adjust Credits

Updated 10 September 2026

POST `?action=referral_adjust`

Grant or take back credits by hand. Writes an adjustment into the ledger — history is never edited, and another adjustment reverses anything. Taking back more than the customer holds is refused (422) — a balance never goes below zero.

Request Parameters

Field	Type	Required	Description
`customer_email`	string	Requiredone of these two	The customer's email
`customer_id`	integer	Requiredone of these two	The customer id
`delta`	integer	Required	Credits to add — negative takes back
`note`	string	Optional	Why — shows in the ledger
`idempotency_key`	string	Optional	Your own reference for this adjustment. Sending the same key again returns the original result instead of adjusting twice

Response Fields

Field	Type	Description
`customer_id`	integer	The customer
`delta`	integer	What was asked for
`applied`	boolean	true when this call changed the balance; false when it matched an earlier idempotency_key and nothing more was applied
`balance`	integer	Their new balance

Example request

$ch = curl_init('PANELR_API_URL?action=referral_adjust');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => '{"customer_email":"[email protected]","delta":50,"note":"Goodwill"}',
    CURLOPT_HTTPHEADER => [
        'X-Panelr-API-Key: YOUR_API_KEY',
        'Content-Type: application/json',
    ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

curl -X POST "PANELR_API_URL?action=referral_adjust" \
  -H "X-Panelr-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer_email":"[email protected]","delta":50,"note":"Goodwill"}'

const res = await fetch('PANELR_API_URL?action=referral_adjust', {
  method: 'POST',
  headers: {
    'X-Panelr-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"customer_email":"[email protected]","delta":50,"note":"Goodwill"}),
});
const { data } = await res.json();

import requests
r = requests.post('PANELR_API_URL',
    params={'action': 'referral_adjust'},
    headers={'X-Panelr-API-Key': 'YOUR_API_KEY'},
    json={"customer_email":"[email protected]","delta":50,"note":"Goodwill"})
data = r.json()['data']

POST ?action=referral_adjust

Request Parameters

Response Fields

POST `?action=referral_adjust`