Sign in

v1

latestOpenAPI 3.0.02026-07-2671142187.3 KB
Payment Plans

Create payment plans

Create one or more payment plans customers can subscribe to.

post/payment-plans

Headers

api-tokenstring required

Your API access token for authentication and access to the Helcim API

Request body

Example request

{
  "paymentPlans": [
    {
      "name": "My new monthly plan",
      "type": "subscription",
      "status": "active",
      "currency": "CAD",
      "cardTerminalId": 12345,
      "setupAmount": 15,
      "recurringAmount": 10.5,
      "billSetupImmediately": "first_billing",
      "billingPeriod": "monthly",
      "billingPeriodIncrements": 1,
      "dateBilling": "Sign-up",
      "termType": "forever",
      "taxType": "customer",
      "taxCalculation": "country_province",
      "paymentMethod": "card",
      "businessEmail": "test@myBusiness.com",
      "isProrated": "no"
    }
  ]
}

Response

Successful payment plan creation. The response body contains the data representation of all newly created payment plans.

Example response

{
  "data": [
    {
      "id": 123456,
      "dateCreated": "2024-01-01 12:30:45",
      "dateUpdated": "1970-01-01 00:00:00",
      "name": "My new monthly plan",
      "description": "",
      "type": "subscription",
      "status": "active",
      "currency": "CAD",
      "cardTerminalId": 12345,
      "setupAmount": 15,
      "recurringAmount": 10.5,
      "billSetupImmediately": "first_billing",
      "billingPeriod": "monthly",
      "billingPeriodIncrements": 1,
      "dateBilling": "Sign-up",
      "termType": "forever",
      "freeTrialPeriod": 0,
      "taxType": "customer",
      "taxCalculation": "country_province",
      "termLength": 0,
      "paymentMethod": "card",
      "businessEmail": "test@myBusiness.com",
      "addOnIds": [],
      "isProrated": "no"
    }
  ]
}