Step 1: Create Products and Define Pricing

Navigate to the Pricing Tab to create products and define their pricing models. Use ready-made templates or start from scratch to create your model.

Click 'Use this Pricing' and use our ‘Spreadsheet-in-a-System’ to edit your pricing. Edit line items, change prices and ranges, connect usage products, define billing logic and more. Once you're done, click on 'Publish' to save the product and add it to your products catalog.

Step 2: Create a Subscription

Navigate to Pricing > Subscriptions to create your subscription plans. You can add multiple products with varying pricing models to each plan. Once you're done, click on 'Update Subscription'. Once you update a subscription plan, the platform automatically generates an embeddable URL for your website. This URL must be embedded in the specific plan's CTA, to ensure accurate billing.

Step 3: Embed Subscription URLs into Your Website

Now that you have a specific URL for each plan, you can embed the appropriate link in the right call-to-action button on your website. Once customers sign up for a subscription, they will be directed to a specific checkout page where they will enter their payment information. The information collected will be used to automatically charge customers based on their specific plan and billing logic.

Step 1: Automatically Sync Customers and Subscriptions

Once you have embedded the custom URLs into your website, Received's platform is ready to automatically 'catch' user information and create new customers and subscriptions. Using APIs, we can access the subscription data from your website to create the following:

1. New Customer Using a specific API, a new customer is automatically created in Customers > Subscriptions. Our API looks like this:

// POST/api/customers

Request body

Example Value

{
  "name": "Received",
  "legal_name": "Received ltd.",
  "email": "admin1@company.com, admin2@company.com",
  "ein": "12-3456789",
  "phone": {
    "countryCode": "1",
    "phone": "2121234567"
  },
  "country": "United States",
  "city": "New York",
  "zip_code": "string",
  "billing_address": "643 Mundy St, Watertown, New York(NY), 13601",
  "shipping_address": "643 Mundy St, Watertown, New York(NY), 13601",
  "country_state": "NY",
  "currency": "USD",
  "tax": 17,
  "entity_ref": "693122c3-54e0-4acd-aeb8-7de4686cea3e",
  "entity_name": "Acme Inc",
  "net_terms": 30,
  "settings": {
    "attach_usage_logs_csv": false,
    "attach_usage_logs_pdf": true
  },
  "icon_data": "string"
}

Responses

Example Value

{
  "customer_ref": "dcaff9c0-4a9c-4d01-b2dc-0da7efcc616c"
}

1. New Subscription Using a specific API, a new subscription is automatically created in Contracts > Subscriptions. Our API looks like this:

// POST/api/contracts/subscriptions

Request body

Example Value

{
  "customer_ref": "19ed1ce4-082b-4cea-8dfb-c7e673f88224",
  "entity_ref": "cec40f99-a2e1-4bd7-805d-9c1a3c2e69a1",
  "po_number": "string",
  "billing_start_date": "2024-02-01T12:05:23.613Z",
  "billing_end_date": "2024-02-01T12:05:23.613Z",
  "issue_day": "2023-07-13",
  "payment_time": "AFTER_USE",
  "tax": 17,
  "discount": 0,
  "net_terms": "DUE_UPON_RECEIPT",
  "note": "string",
  "billing_online_payment_details": {
    "auto_charge": true,
    "payment_gateway_id": "string",
    "payment_gateway_card_id": "string"
  },
  "products": [
    {
      "product_pricing_ref": "string",
      "line_items": [
        {
          "line_item_id": "string"
        }
      ]
    }
  ]
}

Responses

Example Value

{
  "subscription_ref": "32c320bb-431b-488f-bcd4-729e495a33ad"
}

Step 2: Track Subscriptions Data

Navigate to Customers>Subscribers to see all subscriptions data. On this screen you can view the number of subscribers, subscriptions ARR and MRR, payment status, churn rate and more. Received offers an error handling mechanism, which quickly identifies failed payments and automatically sends a new payment link to the customer.

Step 1: Track Usage (for usage-based products)

In the event that a subscription plan includes a usage-based product, Received's usage API automatically tracks and calculates usage rates for each subscriber per billing cycle.

This API is provided by Received, and embedded into your software, enabling automatic usage tracking. Our embeddable API looks like this:

usage_event = {
  "timestamp": "2024-02-05T08:55:32.160Z",
  "customer_ref": "4096966d-5c1c-4e18-8b47-6a365e3c16ea",
  "customer_name": "ACME",
  "usage_product_ref": "bb50da07-c686-4688-8550-66305e17aab0",
  "usage_product_name": "Units",
  "quantity": 10,
  "additional_report_data": {
    "note": "User-specific note"
  },
  "validations": {
    "currency": "USD",
    "entity_ref": "55899733-32a0-4912-9d2e-a5b0f04dcdb6"
  }
}

event_report_resp = requests.post('https://api.received.ai/api/usage/event', headers=headers, data=json.dumps(usage_event))

Once this API is embedded, usage is tracked and collected by Received. When it's time to charge customers, Received's internal API collects the relevant data and calculates the total due for each specific subscription.

Our API looks like this:

// POST/api/usage/event

Request Body

Example Value

{
  "timestamp": "2024-02-05T09:02:27.279Z",
  "customer_ref": "b4fe1e43-321f-479c-aee7-c11d73616ff2",
  "customer_name": "ACME",
  "usage_product_ref": "9db3fbc3-5e77-43c8-828f-bc2b69cbc9f3",
  "usage_product_name": "Units",
  "quantity": 10,
  "additional_report_data": {
    "note": "User-specific note"
  },
  "validations": {
    "currency": "USD",
    "entity_ref": "d78bf43b-e76a-4a70-8f56-d3dfcea0dffe"
  }
}

Responses

Example Value

{
  "event_ref": "d1d3416c-0b33-479e-a42f-dbb74effd290",
  "related_document_ref": "fffb529d-e5ad-4d87-b1e5-fa5085a675b5",
  "related_document_numbers": "US-INV-1234",
  "related_parent_document_ref": "cb88774f-fbdd-42ef-b9eb-822e6c581ee1",
  "related_parent_document_numbers": "US-INV-12345"
}

Step 2: Auto-Charge Customers

Received automatically charges active subscription customers according to their selected plan and usage rates (where applicable), and sends payment confirmations. Upon payment, Received's system automatically matches auto-charged payments with outstanding balances for seamless reconciliation and automatically recognizes revenue according to ASC-606 and IFRS-15 compliance.