New customer checkout with credit card flow

Setting up your tenant for self-service

• Follow our guide to configure the product catalog
• Update the relevant rates to mark them as eligible for self-service.

• Follow our guide to configure Stripe as a payment gateway
  • Make note of the payment gateway ID, it'll be used in an API call later in this guide
  • Configure your Stripe instance to allow credit card collection
• Create an API key that will be supplied when calling our APIs

User signup

When an end user creates an identity in your product, a corresponding MonetizeNow Account and Contact should be created too. This section will cover what entities should be created in our system when a user signs up in your product.

1. A MonetizeNow Account should be created to represent a new user or business you want to bill. Create this relationship via our create account API.
2. Ask the end user for an e-mail address to use to create a MonetizeNow Contact to associate to the aforementioned MonetizeNow Account; this will be used for invoicing. Create this relationship via our create contact API

Product catalog view

Basic Product catalog data

These APIs will allow you to display information about the bundles you are selling.

1. Use our catalog API in order to retrieve your configured self-serviceable rates https://docs.monetizenow.io/reference/product-catalog-api#/api-definition
2. Using the offering properties from the rates response, use our bulk get offerings API to get data about the offering(s) and their underlying product(s).

Pricing

We offer a pricing API to help an end customer preview the cost of what they are buying with real time pricing; you can build an experience that allows your end users to input quantities per product per bundle and see their cost per billing period if they were to checkout with the configuration.

Finalizing checkout

Once the end user is ready to checkout, it will be time to collect their payment information and send the selected offerings configurations to MonetizeNow.

1. Follow our guide to collect payment information in your application using Stripe
   1. To allow future payments, the payment information should be collected by using Stripe SetupIntents. We'll refer to the setup intent ID within MonetizeNow as a 'payment token'.
2. Call our create payment gateway account API that creates a Stripe Customer and an association with it in MonetizeNow.
3. Submit the payment token, along with the data of what is being bought to our new customer checkout API.

After following these steps, you should see in your MonetizeNow tenant that within the Account, a Bill Group will have been created with subscriptions along with an invoice for the first period (if the checked out offerings are billed in advance).