{"_id":"5c6c2407b8d4b2000e72da06","category":{"_id":"5c6c2407b8d4b2000e72d989","version":"5c6c2407b8d4b2000e72da25","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-07-27T10:22:06.636Z","from_sync":false,"order":8,"slug":"subscriptions","title":"Subscriptions"},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"_id":"5c6c2407b8d4b2000e72da25","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5beec5a5f95d82011c6f3714","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z","categories":["5c6c2407b8d4b2000e72d981","5c6c2407b8d4b2000e72d982","5c6c2407b8d4b2000e72d983","5c6c2407b8d4b2000e72d984","5c6c2407b8d4b2000e72d985","5c6c2407b8d4b2000e72d986","5c6c2407b8d4b2000e72d987","5c6c2407b8d4b2000e72d988","5c6c2407b8d4b2000e72d989","5c6c2407b8d4b2000e72d98a","5c6c2407b8d4b2000e72d98b","5c6c2407b8d4b2000e72d98c","5c6c2407b8d4b2000e72d98d","5c6c2407b8d4b2000e72d98e","5c6c2407b8d4b2000e72d98f","5c6c2407b8d4b2000e72d990"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"Main","version_clean":"8976.0.0-XML","version":"8976-XML"},"githubsync":"","__v":0,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-29T12:00:30.497Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"post","results":{"codes":[{"language":"text","code":""}]},"settings":"","auth":"optional","params":[],"url":"/recurring/plans"},"isReference":false,"order":1,"body":"The Create Plan request enables you to set up a subscription billing plan and define the plan's settings, such as the charge frequency, amount, currency, trial period, initial charge amount, and so on.\n\nFor more information about working with subscriptions, see the [Subscriptions tutorial](doc:subscription-management#section-tutorial-subscriptions).\n[block:callout]\n{\n \"type\": \"info\",\n \"title\": \"Need help setting up your plans?\",\n \"body\": \"If you need assistance with creating billing plans, please contact [Merchant Support](https://bluesnap.zendesk.com/hc/en-us/requests/new?ticket_form_id=360000127087).\"\n}\n[/block]\n<a class=\"btn btn-success\" href=\"#section-api-explorer\" role=\"button\">Try it in the API Explorer</a>\n\n###Request Content\n`plan` *container* <span style=\"color:#F37500\">**required**</span>, contains the following properties (see [plan](doc:plan)):\n `name` *string* <span style=\"color:#F37500\">**required**</span>\n `recurring-charge-amount` *decimal* <span style=\"color:#F37500\">**required**</span>\n `currency` *string* <span style=\"color:#F37500\">**required**</span>\n `charge-frequency` *string* <span style=\"color:#F37500\">**required**</span>\n `trial-period-days` *integer* optional\n `initial-charge-amount` *decimal* optional\n `charge-on-plan-switch` *boolean* optional\n `max-number-of-charges` *integer* optional\n `grace-period-days` *integer* optional\n\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response body contains the [plan](doc:plan) resource, which includes the `plan-id`.\nThe `plan-id` also appears in the location header.\n\n<hr>\n\n##Examples\n\n###Request Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/recurring/plans \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<plan xmlns=\\\"http://ws.plimus.com\\\">\\n <name>Gold Plan</name>\\n <recurring-charge-amount>29.99</recurring-charge-amount>\\n <currency>USD</currency>\\n <charge-frequency>MONTHLY</charge-frequency>\\n</plan>'\",\n \"language\": \"curl\",\n \"name\": \"Create Plan Request: basic\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/recurring/plans \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<plan xmlns=\\\"http://ws.plimus.com\\\">\\n <name>Gold Plan</name>\\n <recurring-charge-amount>29.99</recurring-charge-amount>\\n <currency>USD</currency>\\n <charge-frequency>MONTHLY</charge-frequency>\\n <trial-period-days>14</trial-period-days>\\n <initial-charge-amount>100</initial-charge-amount>\\n <charge-on-plan-switch>true</charge-on-plan-switch>\\n <max-number-of-charges>12</max-number-of-charges>\\n <grace-period-days>10</grace-period-days>\\n</plan>'\",\n \"language\": \"curl\",\n \"name\": \"with all settings\"\n }\n ],\n \"sidebar\": true\n}\n[/block]\n###Response Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"HTTP/ 1.1 200 OK\\n\\n<plan xmlns=\\\"http://ws.plimus.com\\\">\\n <plan-id>2111110</plan-id>\\n <name>Gold Plan</name>\\n <recurring-charge-amount>29.99</recurring-charge-amount>\\n <currency>USD</currency>\\n <charge-frequency>MONTHLY</charge-frequency>\\n <status>ACTIVE</status>\\n</plan>\",\n \"language\": \"xml\",\n \"name\": \"Create Plan Response: 200 OK - basic\"\n },\n {\n \"code\": \"HTTP/ 1.1 200 OK\\n\\n<plan xmlns=\\\"http://ws.plimus.com\\\">\\n <plan-id>2111111</plan-id>\\n <name>Gold Plan</name>\\n <recurring-charge-amount>29.99</recurring-charge-amount>\\n <currency>USD</currency>\\n <charge-frequency>MONTHLY</charge-frequency>\\n <trial-period-days>14</trial-period-days>\\n <initial-charge-amount>100</initial-charge-amount>\\n <charge-on-plan-switch>true</charge-on-plan-switch>\\n <max-number-of-charges>12</max-number-of-charges>\\n <grace-period-days>10</grace-period-days>\\n <status>ACTIVE</status>\\n</plan>\",\n \"language\": \"xml\",\n \"name\": \"200 OK - with all settings\"\n }\n ],\n \"sidebar\": true\n}\n[/block]\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##Example Descriptions\n\n###Create Plan: basic\nThis example shows a basic Create Plan request, containing the minimum required fields for a new plan.\n\n###Create Plan: all settings\nThis example shows a Create Plan request with all available plan settings, including a trial period of 14 days, an initial charge of $100, charge on switch enabled, a max limit of 12 charges, and a grace period of 10 days.\n\n<br>\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##API Explorer\nTo test out a call, enter the XML portion of the request below and then click **Try it!**\n[block:callout]\n{\n \"type\": \"info\",\n \"title\": \"Tip:\",\n \"body\": \"Copy the XML portion from one of the example requests above, or use the XML code below as a starting point. You can enter different parameter values to see how your test scenario would work. *The request headers, including authorization, are already built in for you in this test area, so you should not include them here.*\"\n}\n[/block]\n\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"<plan xmlns=\\\"http://ws.plimus.com\\\">\\n <name>Gold Plan</name>\\n <recurring-charge-amount>29.99</recurring-charge-amount>\\n <currency>USD</currency>\\n <charge-frequency>MONTHLY</charge-frequency>\\n <trial-period-days>14</trial-period-days>\\n <initial-charge-amount>100</initial-charge-amount>\\n <charge-on-plan-switch>true</charge-on-plan-switch>\\n <max-number-of-charges>12</max-number-of-charges>\\n <grace-period-days>10</grace-period-days>\\n</plan>\",\n \"language\": \"xml\"\n }\n ]\n}\n[/block]","excerpt":"","slug":"create-plan","type":"endpoint","title":"Create Plan"}postCreate Plan
Definition
{{ api_url }}{{ page_api_url }}
Documentation
The Create Plan request enables you to set up a subscription billing plan and define the plan's settings, such as the charge frequency, amount, currency, trial period, initial charge amount, and so on.
For more information about working with subscriptions, see the Subscriptions tutorial.
Need help setting up your plans?
If you need assistance with creating billing plans, please contact Merchant Support.
Request Content
plan container required, contains the following properties (see plan):
name string required
recurring-charge-amount decimal required
currency string required
charge-frequency string required
trial-period-days integer optional
initial-charge-amount decimal optional
charge-on-plan-switch boolean optional
max-number-of-charges integer optional
grace-period-days integer optional
Response Details
If successful, the response HTTP status code is 200 OK.
The response body contains the plan resource, which includes the plan-id.
The plan-id also appears in the location header.
Examples
Request Examples
curl -v -X POST https://sandbox.bluesnap.com/services/2/recurring/plans \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<plan xmlns="http://ws.plimus.com">
<name>Gold Plan</name>
<recurring-charge-amount>29.99</recurring-charge-amount>
<currency>USD</currency>
<charge-frequency>MONTHLY</charge-frequency>
</plan>'curl -v -X POST https://sandbox.bluesnap.com/services/2/recurring/plans \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<plan xmlns="http://ws.plimus.com">
<name>Gold Plan</name>
<recurring-charge-amount>29.99</recurring-charge-amount>
<currency>USD</currency>
<charge-frequency>MONTHLY</charge-frequency>
<trial-period-days>14</trial-period-days>
<initial-charge-amount>100</initial-charge-amount>
<charge-on-plan-switch>true</charge-on-plan-switch>
<max-number-of-charges>12</max-number-of-charges>
<grace-period-days>10</grace-period-days>
</plan>'HTTP/ 1.1 200 OK
<plan xmlns="http://ws.plimus.com">
<plan-id>2111110</plan-id>
<name>Gold Plan</name>
<recurring-charge-amount>29.99</recurring-charge-amount>
<currency>USD</currency>
<charge-frequency>MONTHLY</charge-frequency>
<status>ACTIVE</status>
</plan>HTTP/ 1.1 200 OK
<plan xmlns="http://ws.plimus.com">
<plan-id>2111111</plan-id>
<name>Gold Plan</name>
<recurring-charge-amount>29.99</recurring-charge-amount>
<currency>USD</currency>
<charge-frequency>MONTHLY</charge-frequency>
<trial-period-days>14</trial-period-days>
<initial-charge-amount>100</initial-charge-amount>
<charge-on-plan-switch>true</charge-on-plan-switch>
<max-number-of-charges>12</max-number-of-charges>
<grace-period-days>10</grace-period-days>
<status>ACTIVE</status>
</plan>Example Descriptions
Create Plan: basic
This example shows a basic Create Plan request, containing the minimum required fields for a new plan.
Create Plan: all settings
This example shows a Create Plan request with all available plan settings, including a trial period of 14 days, an initial charge of $100, charge on switch enabled, a max limit of 12 charges, and a grace period of 10 days.
API Explorer
To test out a call, enter the XML portion of the request below and then click Try it!
Tip:
Copy the XML portion from one of the example requests above, or use the XML code below as a starting point. You can enter different parameter values to see how your test scenario would work. The request headers, including authorization, are already built in for you in this test area, so you should not include them here.
<plan xmlns="http://ws.plimus.com">
<name>Gold Plan</name>
<recurring-charge-amount>29.99</recurring-charge-amount>
<currency>USD</currency>
<charge-frequency>MONTHLY</charge-frequency>
<trial-period-days>14</trial-period-days>
<initial-charge-amount>100</initial-charge-amount>
<charge-on-plan-switch>true</charge-on-plan-switch>
<max-number-of-charges>12</max-number-of-charges>
<grace-period-days>10</grace-period-days>
</plan>