Get Started with Subscriptions
Important: A new Subscriptions version is available. To integrate with the latest APIs, see the most recent integration guide.
Set up your development environment
Before you can integrate Subscriptions, you must set up your development environment. After you get a token that lets you access protected REST API resources, you create sandbox accounts to test your web and mobile apps. For details, see Get started.
Then, return to this page to integrate Subscriptions.
Sample plan
Follow this sample to create a fully functioning payment plan that includes two payment definitions, each with a fixed number of payment cycles and a set of merchant preferences:
{
"name": "Plan with Regular and Trial Payment Definitions",
"description": "Plan with regular and trial payment definitions.",
"type": "fixed",
"payment_definitions": [
{
"name": "Regular payment definition",
"type": "REGULAR",
"frequency": "MONTH",
"frequency_interval": "2",
"amount":
{
"value": "100",
"currency": "USD"
},
"cycles": "12",
"charge_models": [
{
"type": "SHIPPING",
"amount":
{
"value": "10",
"currency": "USD"
}
},
{
"type": "TAX",
"amount":
{
"value": "12",
"currency": "USD"
}
}]
},
{
"name": "Trial payment definition",
"type": "trial",
"frequency": "week",
"frequency_interval": "5",
"amount":
{
"value": "9.19",
"currency": "USD"
},
"cycles": "2",
"charge_models": [
{
"type": "SHIPPING",
"amount":
{
"value": "1",
"currency": "USD"
}
},
{
"type": "TAX",
"amount":
{
"value": "2",
"currency": "USD"
}
}]
}],
"merchant_preferences":
{
"setup_fee":
{
"value": "1",
"currency": "USD"
},
"return_url": "https://example.com/return",
"cancel_url": "https://example.com/cancel",
"auto_bill_amount": "YES",
"initial_fail_amount_action": "CONTINUE",
"max_fail_attempts": "0"
}
}
The plan includes these payment definitions:
Payment definition | The customer is charged | Frequency | Cycles |
---|---|---|---|
Regular | $100 + $10 shipping fee and $12 tax | Every two months | For twelve payment cycles |
Trial | $9.19 + $1 shipping fee and $2 tax | Every five weeks | For two payment cycles |
By default, a plan is not active when you create it. To activate it, you must update its state
to ACTIVE
.