--- page_title: Free tier provisioning product: Juspay Billing page_source: https://juspay.io/in/docs/juspay-billing/docs/billing/free-tier-provisioning openapi: https://juspay.io/in/docs/api/swagger?document=https%3A%2F%2Fjuspay.io%2Fin%2Fdocs%2Fjuspay-billing%2Fdocs%2Fbilling%2Ffree-tier-provisioning llms_txt: https://juspay.io/in/docs/llms.txt product_llms_txt: https://juspay.io/in/docs/juspay-billing/llms.txt --- ## API Version: default # Free Tier Provisioning As part of building **Juspay Billing** , we aim to support a **free-tier onboarding experience** that allows merchants to provision accounts for end customers **before any payment or transaction occurs** . Through a dedicated API, platforms can create billing accounts with a **free plan and optional usage credits** , without requiring a payment method to be attached upfront. This enables businesses—especially SaaS merchants—to offer **free trials, starter tiers, or promotional credits** , allowing users to begin using the product immediately while deferring payment setup to a later stage. > **Note** > Free Tier API creates the billing execution and ledger without initiating any transaction; therefore no mandate is registered (India). To start paid billing, merchants must either create a new billing execution or use the Change Plan API to trigger mandate registration. ## Endpoints: - Sandbox: https://sandbox.juspay.in/billing/execution-info - Production: https://api.juspay.in/billing/execution-info ## Request Type: POST ## Content-Type: application/json ## Authorization: #### Basic Auth: - Value: Basic MUQ2QUxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx== - Tags: Base64 Encoded Username:Password, Required ## Headers: #### x-merchantid: - Value: Juspay_provided_merchant_id - Tags: String #### Content-Type: - Value: application/json - Tags: String ## Sample Code Snippets: ### Sample Request: #### Request Code Snippet: ```request curl --location 'https://sandbox.juspay.in/billing/execution-info/list/{customer_id}' \ --header 'x-merchantid: merchant_id' \ --header 'Content-Type: application/json' \ --header 'Authorization: Basic MjA0xxxxxxxxxxxxxxxxxZBOg==' ``` ### Sample Response: #### Response: ```plaintext { "message": "Success", "merchant_id": "mandate_juspay", "success": true, "billing_execution_info": [ { "source_object_id": "", "status": "ACTIVE", "plan_info": { "plan_type": "POST_DEBIT", "plan_model": "USAGE_BASED", "plan_status": "ACTIVE", "plan_created_at": "2026-03-06 14:05:47", "plan_currency": "INR", "plan_interval": "ASPRESENTED", "plan_name": "test3", "metric_info": [ { "created_at": "2026-01-19T10:08:42Z", "status": "ACTIVE", "unit": "GB", "id": 32, "name": "Sbx-testing-1", "pricing_type": "FIXED", "currency": "INR", "pricing_model": [ { "unit_amount": 10, "up_to": "INFINITY" } ], "used_amount": 0, "description": "Mertric testing 1", "used_till_now": 0, "merchant_id": "mandate_juspay", "event_type": "STORAGE", "aggregation_type": "SUM", "updated_at": "2026-01-19T10:08:42Z" } ], "plan_description": "test 3", "plan_updated_at": "2026-03-06 14:05:50", "plan_id": "test_3", "plan_action_on_failure": "SKIP" }, "billing_execution_info_id": "db110037d80345bb96b0ad08b3dc8d99", "source": "MERCHANT_REF_ID", "amount": 0 }, { "source_object_id": "sandbox-test", "status": "ACTIVE", "plan_info": { "plan_type": "POST_DEBIT", "plan_model": "USAGE_BASED", "plan_status": "ACTIVE", "plan_created_at": "2026-03-06 14:05:47", "plan_currency": "INR", "plan_interval": "ASPRESENTED", "plan_name": "test3", "metric_info": [ { "created_at": "2026-01-19T10:08:42Z", "status": "ACTIVE", "unit": "GB", "id": 32, "name": "Sbx-testing-1", "pricing_type": "FIXED", "currency": "INR", "pricing_model": [ { "unit_amount": 10, "up_to": "INFINITY" } ], "used_amount": 0, "description": "Mertric testing 1", "used_till_now": 0, "merchant_id": "mandate_juspay", "event_type": "STORAGE", "aggregation_type": "SUM", "updated_at": "2026-01-19T10:08:42Z" } ], "plan_description": "test 3", "plan_updated_at": "2026-03-06 14:05:50", "plan_id": "test_3", "plan_action_on_failure": "SKIP" }, "billing_execution_info_id": "6d17110f4a90416b8b778e657ff821e0", "source": "MERCHANT_REF_ID", "amount": 11 } ], "customer_id": "cth_gjZV6jYaYxLDLu96" } ``` ## Body Parameters: ### Basic Parameters: #### Command: - Description: This is a command thats needed to create and activate the billing execution id without transaction - Value: create - Tags: String, Required #### plan_id: - Description: The plan_id is needed against which the billing execution id will be created - Value: test_plan - Tags: String, Required #### customer_id: - Description: Need to send the customer id at Juspays system against which the billing execution id will be created. If the customer id is not present, we have to create a customer first - Value: cth_6JKCEXzbM2m5HUwH - Tags: String, Required #### amount: - Description: The amount thats needed to be added against the billing execution id as a part of free tier. Currency here will be the same thats attached to the plan_id and metric_id.Default - Will be zero - Value: 8 - Tags: String #### merchant_ref_id: - Description: Merchant can pass one merchant-generated identifier here - Value: test_1 - Tags: String #### status: - Description: Whatever state the billing execution id is needed to be created at Juspays end, can be used here. > **Note** > Billing execution id needs to be active here before sending the subsequent events request Default - ACTIVEStatuses can be one of the followingCREATED, ACTIVE, INACTIVE - Value: ACTIVE - Tags: String #### metric_info: - Description: In case the plan_type is VARIABLE ( unique metrics for every customer ) here then this is needed to be passed same as orders , otherwise not needed.Here metric_id, pricing_type, pricing model(s) are needed to be passed - Value: Object of metrics ids - Tags: JSON ## API Responses: ### 200: #### status: - Description: Status of the billing execution info id - Value: CREATED - Tags: String #### source_object_id: - Description: Merchant_reference_id sent during the request - Value: 1 - Tags: String #### plan_info: - Description: Plan details of the id sent in the request and configured on Juspays end. - Value: plan info Array - Tags: Array #### order_id: - Value: Ord_1765191076 - Tags: String #### billing_execution_info_id: - Description: The billing_execution_info_id at Juspays end . - Value: 6675969c95234e1e9a9be89af1ee25e2 - Tags: String #### source: - Description: Source from which the billing execution id has been created - Tags: String #### merchant_id: - Description: Id provided by the merchant - Tags: String #### amount: - Description: The amount that was supposed to be added as the default against a billing execution id. - Tags: String #### success: - Description: API status - Tags: String #### customer_id: - Description: Customer id that was passed during the request - Tags: String --- ## See Also - [Get Execution Info ](https://juspay.io/in/docs/juspay-billing/docs/billing/get-execution-info) - [Billing execution ids against customer id](https://juspay.io/in/docs/juspay-billing/docs/billing/billing-execution-ids-against-customer-id)