Skip to main content

FastSpring

FastSpring is a Merchant of Record (MoR) that handles global tax compliance, VAT/GST, and local payment methods. Subscribd integrates with the FastSpring API.

Configuration

Environment variables

Checkout flow

FastSpring uses a hosted storefront for checkout. CreateSubscription returns an Incomplete subscription with a checkout_url in meta. Redirect the user to complete payment:
SubscriptionCreated fires from the webhook handler after FastSpring confirms the order.

Webhooks

Configure a webhook endpoint at https://yourapp.com/subscribd/webhook/fastspring in your FastSpring Dashboard under Developer > Webhooks. Enable:
  • subscription.activated
  • subscription.updated
  • subscription.canceled
  • subscription.deactivated
  • order.completed
  • order.failed
Set the HMAC Secret in FastSpring and add it as FASTSPRING_WEBHOOK_SECRET.

Limitations

  • Proration is handled by Subscribd’s built-in ProrationEngine.
  • Trial extension is not supported natively. ExtendTrial updates the local trial_ends_at only.
  • Pausing is not supported natively. Subscribd updates the local status only.

Next steps

  • Square — Card-present and online payments
  • Webhooks — Full webhook reference