Store Credit Management API

function subscribfyStoreCredit(array $params): array
{
    $ch = curl_init('https://app1.subscribfy.com/api/v1/store-credit/manage');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => ['Accept: application/json'],
        CURLOPT_POSTFIELDS => http_build_query(['key' => getenv('SUBSCRIBFY_API_KEY')] + $params),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 15,
    ]);

    $body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($body === false) {
        throw new RuntimeException('Request to Subscribfy failed');
    }

    $data = json_decode($body, true);
    if ($status !== 200) {
        throw new RuntimeException($data['message'] ?? $data['error'] ?? "HTTP $status");
    }

    return $data;
}

// Get balance
$balance = subscribfyStoreCredit([
    'cid' => '7211677024514',
    'email' => 'customer@example.com',
    'action' => 'get',
]);
echo 'Balance: ' . $balance['store_credit_balance'];

// Add credits
subscribfyStoreCredit([
    'cid' => '7211677024514',
    'email' => 'customer@example.com',
    'action' => 'update',
    'update_value' => 25,
    'update_reason' => 'Loyalty reward',
    'update_type' => 'manual admin adjustment',
]);

// Deduct credits
subscribfyStoreCredit([
    'cid' => '7211677024514',
    'email' => 'customer@example.com',
    'action' => 'update',
    'update_value' => -10,
    'update_reason' => 'Converted to gift card',
    'update_type' => 'reconciled',
]);

const ENDPOINT = 'https://app1.subscribfy.com/api/v1/store-credit/manage';

async function subscribfyStoreCredit(params) {
  const response = await fetch(ENDPOINT, {
    method: 'POST',
    headers: { Accept: 'application/json' },
    body: new URLSearchParams({ key: process.env.SUBSCRIBFY_API_KEY, ...params }),
    signal: AbortSignal.timeout(15000),
  });

  const data = await response.json();
  if (!response.ok) {
    throw new Error(data.message ?? data.error ?? `HTTP ${response.status}`);
  }

  return data;
}

// Get balance
const balance = await subscribfyStoreCredit({
  cid: '7211677024514',
  email: 'customer@example.com',
  action: 'get',
});
console.log(`Balance: ${balance.store_credit_balance}`);

// Add credits
await subscribfyStoreCredit({
  cid: '7211677024514',
  email: 'customer@example.com',
  action: 'update',
  update_value: '25',
  update_reason: 'Loyalty reward',
  update_type: 'manual admin adjustment',
});

// Deduct credits
await subscribfyStoreCredit({
  cid: '7211677024514',
  email: 'customer@example.com',
  action: 'update',
  update_value: '-10',
  update_reason: 'Converted to gift card',
  update_type: 'reconciled',
});

import os
import requests

ENDPOINT = 'https://app1.subscribfy.com/api/v1/store-credit/manage'

def subscribfy_store_credit(**params):
    response = requests.post(
        ENDPOINT,
        data={'key': os.environ['SUBSCRIBFY_API_KEY'], **params},
        headers={'Accept': 'application/json'},
        timeout=15,
    )
    data = response.json()
    if not response.ok:
        raise RuntimeError(data.get('message') or data.get('error') or f'HTTP {response.status_code}')
    return data

# Get balance
balance = subscribfy_store_credit(cid='7211677024514', email='customer@example.com', action='get')
print(f"Balance: {balance['store_credit_balance']}")

# Add credits
subscribfy_store_credit(
    cid='7211677024514',
    email='customer@example.com',
    action='update',
    update_value=25,
    update_reason='Loyalty reward',
    update_type='manual admin adjustment',
)

# Deduct credits
subscribfy_store_credit(
    cid='7211677024514',
    email='customer@example.com',
    action='update',
    update_value=-10,
    update_reason='Converted to gift card',
    update_type='reconciled',
)