post https://api.chartmogul.com/v1/plans
Creates a plan
object in ChartMogul under the specified data_source
.
Examples
curl -X POST "https://api.chartmogul.com/v1/import/plans" \
-u YOUR_API_KEY: \
-H "Content-Type: application/json" \
-d '{
"data_source_uuid": "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
"name": "Bronze Plan",
"interval_count": 1,
"interval_unit": "month",
"external_id": "plan_0001"
}'
ChartMogul::Import::Plan.create!(
data_source_uuid: "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
name: "Bronze Plan",
interval_count: 1,
interval_unit: "month",
external_id: "plan_0001",
)
ChartMogul.Plan.create(config, {
data_source_uuid: "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
name: "Bronze Plan",
interval_count: 1,
interval_unit: "month",
external_id: "plan_0001",
});
ChartMogul\Import\Plan::create([
"data_source_uuid" => "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
"name" => "Bronze Plan",
"interval_count" => 1,
"interval_unit" => "month",
"external_id" => "plan_0001"
]);
api.CreatePlan(&cm.Plan{
DataSourceUUID: "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
Name: "Bronze Plan",
IntervalCount: 1,
IntervalUnit: "month",
ExternalID: "plan_0001",
})
chartmogul.Plan.create(
config,
data={
"data_source_uuid": "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
"name": "Bronze Plan",
"interval_count": 1,
"interval_unit": "month",
"external_id": "plan_0001",
},
)
Result Format
{
"uuid": "pl_eed05d54-75b4-431b-adb2-eb6b9e543206",
"data_source_uuid": "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
"name": "Bronze Plan",
"interval_count": 1,
"interval_unit": "month",
"external_id": "plan_0001"
}
#<ChartMogul::Import::Plan:0x007fb4993f25a0
@uuid="pl_eed05d54-75b4-431b-adb2-eb6b9e543206",
@data_source_uuid="ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
@name="Bronze Plan",
@interval_count=1,
@interval_unit="month",
@external_id="plan_0001"
>
{
uuid: "pl_eed05d54-75b4-431b-adb2-eb6b9e543206",
data_source_uuid: "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
name: "Bronze Plan",
interval_count: 1,
interval_unit: "month",
external_id: "plan_0001"
}
ChartMogul\Import\Plan::__set_state(array(
"uuid" => "pl_eed05d54-75b4-431b-adb2-eb6b9e543206",
"name" => "Bronze Plan",
"interval_count" => 1,
"interval_unit" => "month",
"external_id" => "plan_0001",
"data_source_uuid" => "ds_fef05d54-47b4-431b-aed2-eb6b9e545430"
));
(*chartmogul.Plan)(0xc04203e5a0)({
UUID: (string) (len=39) "pl_eed05d54-75b4-431b-adb2-eb6b9e543206",
DataSourceUUID: (string) (len=39) "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
ExternalID: (string) (len=9) "plan_0001",
Name: (string) (len=11) "Bronze Plan",
IntervalCount: (uint32) 1,
IntervalUnit: (string) (len=5) "month"
})
<Plan{
data_source_uuid="ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
external_id="plan_0001",
interval_count=1,
interval_unit="month",
name="Bronze Plan",
uuid="pl_eed05d54-75b4-431b-adb2-eb6b9e543206"
}>
In the response, the JSON
object contains the following data:
uuid
- The UUID of theplan
object generated by ChartMogul.data_source_uuid
- The UUID of the data source that this subscription plan belongs to.name
- Name of this plan, as specified by you.interval_count
- The number of intervals (specified in theinterval_unit
attribute) between each billing date.interval_unit
- The frequency with which a subscription for this plan is billed. For example, if you bill your customer every 3 months for a subscription with this plan, theninterval_count
would be3
andinterval_unit
would bemonth
.external_id
- The unique external identifier for this plan, as specified by you.