Billing Simulator

A unofficial tool to help you to visualize Stripe Billing Schedule and generate a postman api collection to run the subscription through each event. how to use

Schedule

create_date

billing_cycle_anchor

trial_end

proration_behavior

Price

Billing Simulator doesn't support all complex pricing model now. You can add additional paramter once you import the script to postman.

unit_amount

currency

interval

interval_count

usage_type

tiers_mode

2024/11/1

{
  "info": {
    "_postman_id": "billing_simulator_2024-11-22T13:59:43",
    "name": "billing_simulator_2024-11-22T13:59:43",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{secret_key}}",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "/test_helpers/test_clocks",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.collectionVariables.set(\"clock_id\", pm.response.json().id);"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "description": "create test clock",
      "request": {
        "method": "post",
        "header": [],
        "url": {
          "raw": "https://api.stripe.com",
          "protocol": "https",
          "host": [
            "api",
            "stripe",
            "com"
          ],
          "path": [
            "v1",
            "test_helpers",
            "test_clocks"
          ]
        },
        "body": {
          "mode": "urlencoded",
          "urlencoded": [
            {
              "key": "frozen_time",
              "value": 1732233600,
              "type": "text"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "/prices",
      "description": "Billing Simulator month product",
      "request": {
        "method": "post",
        "header": [],
        "url": {
          "raw": "https://api.stripe.com",
          "protocol": "https",
          "host": [
            "api",
            "stripe",
            "com"
          ],
          "path": [
            "v1",
            "prices"
          ]
        },
        "body": {
          "mode": "urlencoded",
          "urlencoded": [
            {
              "key": "",
              "value": "",
              "type": ""
            },
            {
              "key": "currency",
              "value": "usd",
              "type": "text"
            },
            {
              "key": "unit_amount",
              "value": "1000",
              "type": "text"
            },
            {
              "key": "product_data[name]",
              "value": "Billing Simulator month product_2024-11-22T13:59:43",
              "type": "text"
            },
            {
              "key": "recurring[interval]",
              "value": "month",
              "type": "text"
            },
            {
              "key": "recurring[usage_type]",
              "value": "licensed",
              "type": "text"
            },
            {
              "key": "recurring[interval_count]",
              "value": "1",
              "type": "text"
            },
            "",
            ""
          ]
        }
      },
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.collectionVariables.set(\"price_id\", pm.response.json().id);"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "response": []
    },
    {
      "name": "/customers",
      "description": "",
      "request": {
        "method": "post",
        "header": [],
        "url": {
          "raw": "https://api.stripe.com",
          "protocol": "https",
          "host": [
            "api",
            "stripe",
            "com"
          ],
          "path": [
            "v1",
            "customers"
          ]
        },
        "body": {
          "mode": "urlencoded",
          "urlencoded": [
            {
              "key": "test_clock",
              "value": "{{clock_id}}",
              "type": "text"
            },
            {
              "key": "name",
              "value": "Billing_Simulator_Test_Cusotmer_2024-11-22T13:59:43",
              "type": "text"
            },
            {
              "key": "payment_method",
              "value": "pm_card_visa",
              "type": "text"
            },
            {
              "key": "invoice_settings[default_payment_method]",
              "value": "pm_card_visa",
              "type": "text"
            },
            {
              "key": "email",
              "value": "kokaj91545@cupbest.com",
              "type": "text"
            }
          ]
        }
      },
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.collectionVariables.set(\"customer_id\", pm.response.json().id);"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "response": []
    },
    {
      "name": "/subscriptions",
      "description": "",
      "request": {
        "method": "post",
        "header": [],
        "url": {
          "raw": "https://api.stripe.com",
          "protocol": "https",
          "host": [
            "api",
            "stripe",
            "com"
          ],
          "path": [
            "v1",
            "subscriptions"
          ]
        },
        "body": {
          "mode": "urlencoded",
          "urlencoded": [
            {
              "key": "customer",
              "value": "{{customer_id}}",
              "type": "text"
            },
            {
              "key": "items[0][price]",
              "value": "{{price_id}}",
              "type": "text"
            },
            {
              "key": "items[0][quantity]",
              "value": "1",
              "type": "text"
            },
            {
              "key": "proration_behavior",
              "value": "none",
              "type": "text"
            },
            "",
            ""
          ]
        }
      },
      "event": [],
      "response": []
    },
    "",
    "",
    {
      "name": "/test_helpers/test_clocks/{{clock_id}}/advance",
      "description": "advance to first update date",
      "request": {
        "method": "post",
        "header": [],
        "url": {
          "raw": "https://api.stripe.com",
          "protocol": "https",
          "host": [
            "api",
            "stripe",
            "com"
          ],
          "path": [
            "v1",
            "test_helpers",
            "test_clocks",
            "{{clock_id}}",
            "advance"
          ]
        },
        "body": {
          "mode": "urlencoded",
          "urlencoded": [
            {
              "key": "frozen_time",
              "value": 1734829200,
              "type": "text"
            }
          ]
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "exec": [
              "pm.collectionVariables.set(\"clock_status\", \"not_ready\");",
              "",
              "const sendRequest = () => {",
              "    pm.sendRequest({",
              "        url: \"https://api.stripe.com/v1/test_helpers/test_clocks/\" + pm.variables.get(\"clock_id\"),",
              "        method: \"get\",",
              "        header: {",
              "            'Authorization': 'Bearer' + ' ' + pm.environment.get(\"secret_key\"),",
              "        },",
              "    }, function (err, response) {",
              "        console.log(response.json())",
              "        if (response.json().status !== 'ready') {",
              "            checkClock();",
              "",
              "        } else {",
              "            pm.collectionVariables.set('clock_status', response.json().status)",
              "        }",
              "",
              "    })",
              "}",
              "",
              "const checkClock = async () => {",
              "    if (pm.variables.get('clock_status') === 'ready') {",
              "        return null",
              "    }",
              "    else {",
              "        setTimeout(",
              "            sendRequest, 5000)",
              "    }",
              "}",
              "checkClock();",
              ""
            ],
            "type": "text/javascript"
          }
        }
      ],
      "response": []
    }
  ],
  "variable": [
    {
      "key": "secret_key",
      "value": ""
    }
  ]
}

Schedule

Price

Postman Import Script