npm install @fype/sdk

import { Fype } from '@fype/sdk';

const fype = new Fype({
 apiKey: 'fype_test_...',
});

// Create a payment
const payment = await fype.payments.create({
 amount: 25000,
 currency: 'INR',
 customer_email: 'jane@example.com',
 success_url: 'https://example.com/success',
 cancel_url: 'https://example.com/cancel',
});

console.log(payment.checkout_url);

// Process a refund
const refund = await fype.refunds.create({
 payment_id: payment.id,
 amount: 5000,
});

// Verify webhook signature
try {
  fype.webhooks.verifySignature(rawBody, signatureHeader, "whsec_...");
} catch (error) {
  // Invalid signature
}

// Create subscription (automatically provisions checkout session)
const subscription = await fype.subscriptions.create({
 customer_id: "customer_uuid",
 plan_id: "plan_uuid",
 price_id: "price_uuid",
 quantity: 1,
 metadata: { referrer: "ad_campaign" }
});

console.log(subscription.checkout_url);

// Retrieve a subscription status
const subDetails = await fype.subscriptions.retrieve("sub_uuid");

// List paginated subscriptions
const subsList = await fype.subscriptions.list({ limit: 10, customer_id: "customer_uuid" });

// Pause, Resume, and Cancel
await fype.subscriptions.pause("sub_uuid");
await fype.subscriptions.resume("sub_uuid");
await fype.subscriptions.cancel("sub_uuid", true); // true = cancel at period end

// Upgrade/Downgrade subscription mid-cycle with proration
await fype.subscriptions.changePlan("sub_uuid", "new_plan_uuid", "new_price_uuid");

// Get transition history
const events = await fype.subscriptions.getEvents("sub_uuid");

// Create a new billing plan under a product
const plan = await fype.plans.create("product_uuid", {
 name: "Pro Monthly",
 description: "Monthly plan for pro features",
 billing_frequency: "monthly",
 billing_interval: 1,
 trial_period_days: 7
});

// Retrieve a plan configuration
const planDetails = await fype.plans.retrieve(plan.id);

// Verify if a customer has a specific active entitlement/privilege
const hasAccess = await fype.entitlements.check("customer_uuid", "advanced_analytics");
if (hasAccess) {
  // Enable feature
}

// Report a consumption event for metered pricing models
await fype.usage.report({
 subscription_id: "sub_uuid",
 event_type: "api_tokens",
 quantity: 250.0,
 unit: "tokens",
 metadata: { model: "gpt-4o" }
});

pip install fype-sdk-beta

from fype import Fype

fype = Fype(api_key="fype_test_...")

# Create a payment
payment = fype.payments.create(
 amount=25000,
 currency="INR",
 customer_email="jane@example.com",
 success_url="https://example.com/success",
 cancel_url="https://example.com/cancel"
)

print(payment['checkout_url'])

# Verify webhook signature
# Returns True if valid, raises SignatureVerificationError if invalid
is_valid = fype.webhooks.verify_signature(
 raw_payload=request.body(),
 signature_header=request.headers.get('X-Fype-Signature'),
 secret="whsec_..."
)

# Create subscription (automatically provisions checkout session)
subscription = fype.subscriptions.create(
 customer_id="customer_uuid",
 plan_id="plan_uuid",
 price_id="price_uuid",
 quantity=1,
 metadata={"referrer": "ad_campaign"}
)

print(subscription['checkout_url'])

# Retrieve a subscription status
sub_details = fype.subscriptions.retrieve(subscription_id="sub_uuid")
print(sub_details['status']) # e.g. "active", "past_due"

# List paginated subscriptions
subs_list = fype.subscriptions.list(limit=10, customer_id="customer_uuid")

# Pause billing cycles
fype.subscriptions.pause(subscription_id="sub_uuid")

# Resume billing cycles
fype.subscriptions.resume(subscription_id="sub_uuid")

# Cancel subscription (optionally at period end)
fype.subscriptions.cancel(subscription_id="sub_uuid", cancel_at_period_end=True)

# Upgrade/Downgrade subscription mid-cycle with proration
updated_sub = fype.subscriptions.change_plan(
 subscription_id="sub_uuid",
 plan_id="new_plan_uuid",
 price_id="new_price_uuid"
)

# Get transition history logs
events = fype.subscriptions.get_events(subscription_id="sub_uuid")

# Create a new billing plan under a product
plan = fype.plans.create(
 product_id="product_uuid",
 name="Pro Monthly",
 description="Monthly plan for pro features",
 billing_frequency="monthly",
 billing_interval=1,
 trial_period_days=7
)

# Retrieve a plan configuration
plan_details = fype.plans.retrieve(plan_id=plan['id'])

# Verify if a customer has a specific active entitlement/privilege
has_access = fype.entitlements.check(
 customer_id="customer_uuid",
 entitlement_identifier="advanced_analytics"
)

if has_access:
 # Enable feature
 pass

# Report a consumption event for metered pricing models
report_res = fype.usage.report(
 subscription_id="sub_uuid",
 event_type="api_tokens",
 quantity=250.0,
 unit="tokens",
 metadata={"model": "gpt-4o"}
)