Billing, Onboarding, and Better Charges

Partners can now manage billing, onboarding, and usage-based charging — directly through the API. No waiting. No manual setup. No middle steps.

Billing Plan API

Create billing plans without contacting us.

Partners can now create and publish their own billing plans through API or the Partner Portal.

This means you can define new pricing, subscriptions, and packages instantly — without Surfboard intervention or activation delays.

{
  "planName": "surf059",
  "currency": 752,
  "description": "High volume merchant plan",
  "planType": "FIXED", // IC++
  "terminalType": ["STANDARD", "ONLINE", "SOFTPOS"],
  "paymentMethods":{
     "domesticDebitNonCommercial":{
       "fixedFee": 2,
       "minimumFee": 0.99,
       "fixedPercentage": 2,
       "splitCards": false,
     }
  }
}

"paymentMethods":{
    "domesticDebitNonCommercial":{
      "fixedFee": 2,
      "minimumFee": 0.99,
      "fixedPercentage": 2,
      "splitCards": false,
    }
}

Partners can now:

→ Create new plans for specific markets, payment methods or merchant segments

→ Push them live instantly without waiting for manual activation

→ Manage all plans directly from the Partner Portal or via API

New Onboarding API

Full control of merchant onboarding.

The new onboarding API lets partners complete every part of merchant registration programmatically — from details and documentation to payment method activation.

✅ Supports every field in the onboarding form

✅ Enables APMs activation at signup

✅ Automatically provisions the first Online terminal for non-SDK partners

✅ Includes templates for Terms of Service and Privacy Policy

Now you can build your own onboarding experience directly into your systems and let us take care of the rest.

Better Charges API

Usage-based billing for the new economy.

The new Charges API introduces dynamic, usage-based billing.

Partners can now create charges that adapt to consumption — ideal for credits, seats, API usage or any other flexible pricing model.

Think of it as the billing foundation for platforms that sell AI credits, subscription tiers or transaction-based access.

This opens entirely new opportunities for your platforms:

→ AI or API billing by tokens or requests

→ Subscription plans with flexible overage pricing

→ Transaction-based partner revenue models

{
  "usage": {
     "used": 350,
     "metric": "credits",
     "limit": 1000,
     "ratePerUnit": 1.5
  },
  "metaData":{
     "planType": "AiUsage",
     "partner": "SurfAi",
   }
}

"usage": {
  "used": 20,
  "metric": "credits",
  "limit": 500,
  "ratePerUnit": 1
}

Every usage entry can carry its own metric, unit rate, and metadata — giving partners the flexibility to track, bill, and display consumption in any way they want. Charge for value, not just time.

💬 This update is launching as a Beta, and we’re looking for partners to test it early. If you’d like to participate, reach out to us, we’d love your feedback.