Agency App Reselling Config API in Sparkforge

The Agency App Reselling Config API surfaces marked-up app prices inside custom plan cards, paywalls, and checkout flows. It returns the exact rebilling configuration Sparkforge stores for each sub-account so client-facing prices stay consistent across surfaces.

What the API Returns

Technically the Get Rebilling Config for App endpoint, this Marketplace developer REST endpoint returns the final client-facing prices an agency has set for a specific app. When called with a sub-account OAuth token, the response includes every active subscription, one-time, and usage-based rate.

Why Use It

• Prevents price mismatches between custom UI and the native Marketplace.
• Protects internal cost prices — only the agency upsell price is returned.
• Covers subscription, one-time, and usage-based billing in one call.
• Keeps checkout flows white-labeled.
• No more hard-coded plan IDs or markups.

Authentication

A valid sub-account (location) access token is required. Calling with an agency or developer token returns 403 Forbidden.

• OAuth 2.0 Authorization Code or Refresh Token flow.
• Token scope must include marketplace.app.read.
• Rate limit: 60 requests/min per app (subject to change).

Response Objects

The JSON response is namespaced under subscriptionPlans, oneTimePlans, and usageMeters. Each array entry includes planId, planName, currency, price, and billingInterval.

Use these fields to build:

• Monthly/annual toggle buttons (from billingInterval).
• Usage tier charts (from included units and overage rate).
• Limited-time offers (from planName or metadata tags).

Display Best Practices

• Refresh prices when a user changes plan quantity or billing cycle.
• Cache the response for 5–10 minutes to respect rate limits.
• Label currency and billing interval explicitly.
• Match agency colors and typography for a fully white-labeled experience.
• Test edge cases where the agency removes a plan or sets price to 0.