{"id":11140,"date":"2024-08-20T12:45:10","date_gmt":"2024-08-20T12:45:10","guid":{"rendered":"https:\/\/spreecommerce.org\/?post_type=cpt_integrations&#038;p=11140"},"modified":"2024-08-21T13:23:42","modified_gmt":"2024-08-21T13:23:42","slug":"braintree-recurring-billing-and-spree-integration","status":"publish","type":"cpt_integrations","link":"https:\/\/spreecommerce.org\/integrations\/braintree-recurring-billing-and-spree-integration\/","title":{"rendered":"Braintree Recurring Billing and Spree integration"},"content":{"rendered":"\n<p>With&nbsp;<a href=\"https:\/\/www.braintreepayments.com\/pl\/features\/recurring-billing\" target=\"_blank\" rel=\"noreferrer noopener\">Braintree Recurring Billing<\/a>&nbsp;you can easily accept repeat online payments for software, subscription-based businesses, donations, and more.<br>The benefits of using Braintree Recurring Billing for your ecommerce business:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Flexible pricing<\/strong><\/h3>\n\n\n\n<p>Create custom pricing plans for your customers. Set up discounts, add-ons, promotional periods, and rewards.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Prorated subscriptions<\/strong><\/h3>\n\n\n\n<p>Your customers have the ability to upgrade or downgrade their subscriptions at any time.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Securely store billing info<\/strong><\/h3>\n\n\n\n<p>Keep your customers\u2019 information in the&nbsp;<a href=\"https:\/\/articles.braintreepayments.com\/control-panel\/vault\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Braintree Vault<\/a>&nbsp;to make repeat billing easy.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Help increase successful transactions<\/strong><\/h3>\n\n\n\n<p>Customize your settings to automatically retry past-due subscriptions and notify customers with custom emails.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Robust reporting<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>View and manage everything in one place<\/strong><\/li>\n<\/ul>\n\n\n\n<p>Search for plans and subscriptions, and filter by pricing plan, subscription ID, billing periods remaining, and price right from your Control Panel.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Stay up to date<\/strong><\/li>\n<\/ul>\n\n\n\n<p>Configure webhooks to receive the status of a subscription and get instant notifications when significant events occur.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to integrate Braintree Recurring Billing with Spree<\/h2>\n\n\n\n<p>With Braintree\u2019s recurring billing, you can charge your customers automatically in monthly increments.<\/p>\n\n\n\n<p>To set this up, you\u2019ll need to&nbsp;<a href=\"https:\/\/articles.braintreepayments.com\/guides\/recurring-billing\/plans\" target=\"_blank\" rel=\"noreferrer noopener\">create a plan<\/a>&nbsp;in the Control Panel and&nbsp;<a href=\"https:\/\/developers.braintreepayments.com\/guides\/customers\/ruby#create\" target=\"_blank\" rel=\"noreferrer noopener\">store your customers in the Vault<\/a>. Then use&nbsp;<a href=\"https:\/\/developers.braintreepayments.com\/reference\/request\/subscription\/create\/ruby\" target=\"_blank\" rel=\"noreferrer noopener\"><code>Subscription.create()<\/code><\/a>&nbsp;to associate each customer\u2019s preferred payment method with the plan.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Integration steps<\/strong><\/h3>\n\n\n\n<p>In addition to the steps listed below, you must&nbsp;<a href=\"https:\/\/developers.braintreepayments.com\/guides\/customers\/ruby#create\" target=\"_blank\" rel=\"noreferrer noopener\">create customers with payment methods<\/a>&nbsp;in the Vault before you can use recurring billing.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><a href=\"https:\/\/developers.braintreepayments.com\/guides\/recurring-billing\/plans\" target=\"_blank\" rel=\"noreferrer noopener\">Creating plans<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/developers.braintreepayments.com\/guides\/recurring-billing\/create\/ruby\" target=\"_blank\" rel=\"noreferrer noopener\">Creating subscriptions<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/developers.braintreepayments.com\/guides\/recurring-billing\/manage\/ruby\" target=\"_blank\" rel=\"noreferrer noopener\">Managing subscriptions<\/a><\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Subscription statuses<\/strong><\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter\"><img decoding=\"async\" width=\"775\" height=\"677\" src=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2020\/05\/flow_subscription-workflow.png\" alt=\"Braintree Recurring Billing integration with Spree Commerce\" class=\"wp-image-6999\" srcset=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2020\/05\/flow_subscription-workflow.png 775w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2020\/05\/flow_subscription-workflow-300x262.png 300w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2020\/05\/flow_subscription-workflow-768x671.png 768w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2020\/05\/flow_subscription-workflow-600x524.png 600w\" sizes=\"(max-width: 775px) 100vw, 775px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Pending<\/h3>\n\n\n\n<p><em>Pending<\/em>&nbsp;subscriptions are subscriptions that have not started yet. For example, if you create a subscription with a specific billing date in the future, the subscription will start out as&nbsp;<em>Pending<\/em>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Active<\/h3>\n\n\n\n<p><em>Active<\/em>&nbsp;subscriptions will be charged on the next billing date. You can get the dates from the&nbsp;<a href=\"https:\/\/developers.braintreepayments.com\/reference\/response\/subscription\/ruby\" target=\"_blank\" rel=\"noreferrer noopener\">subscription object<\/a>. Subscriptions in a trial period are&nbsp;<em>Active<\/em>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Past Due<\/h3>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>NOTE<\/p>\n\n\n\n<p>Braintree can send email notifications to your customers when their subscription becomes past due. See this&nbsp;<a href=\"https:\/\/articles.braintreepayments.com\/guides\/recurring-billing\/email-notifications\" target=\"_blank\" rel=\"noreferrer noopener\">support article<\/a>&nbsp;for more information.<\/p>\n<\/blockquote>\n\n\n\n<p>If a payment for a subscription fails, the subscription status will change to&nbsp;<em>Past Due<\/em>. You can manually retry the charge, or you can&nbsp;<a href=\"https:\/\/articles.braintreepayments.com\/guides\/recurring-billing\/recurring-advanced-settings#automatic-retries\" target=\"_blank\" rel=\"noreferrer noopener\">set up logic in the Control Panel<\/a>&nbsp;to automatically retry a declined or failed charge at specific intervals. Additionally, a past due subscription will be automatically retried if&nbsp;<a href=\"https:\/\/developers.braintreepayments.com\/guides\/recurring-billing\/manage\/ruby#updating-past-due-subscriptions\" target=\"_blank\" rel=\"noreferrer noopener\">the payment method associated with the subscription is updated<\/a>&nbsp;and you have&nbsp;<a href=\"https:\/\/articles.braintreepayments.com\/guides\/recurring-billing\/recurring-advanced-settings#proration\" target=\"_blank\" rel=\"noreferrer noopener\">proration enabled<\/a>. If the retried transaction is successful and the subscription has not passed its final billing date, the status will change to&nbsp;<em>Active<\/em>.<\/p>\n\n\n\n<p>If a retried transaction is unsuccessful, the balance on the past due subscription will continue to increase every billing cycle, and we\u2019ll continue to retry the transaction each billing cycle\u2014either indefinitely or until the number of cycles in the subscription is reached. If all retries are unsuccessful, the subscription\u2019s status will remain&nbsp;<em>Past Due<\/em>&nbsp;until the subscription a) reaches the specified&nbsp;<a href=\"https:\/\/articles.braintreepayments.com\/guides\/recurring-billing\/billing-cycles#number-of-billing-cycles\" target=\"_blank\" rel=\"noreferrer noopener\">number of billing cycles<\/a>,&nbsp;and the status changes to&nbsp;<em>Expired<\/em>, or b) is canceled.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Expired<\/h3>\n\n\n\n<p>Subscriptions are&nbsp;<em>Expired<\/em>&nbsp;when they have reached the specified&nbsp;<a href=\"https:\/\/articles.braintreepayments.com\/guides\/recurring-billing\/billing-cycles#number-of-billing-cycles\" target=\"_blank\" rel=\"noreferrer noopener\">number of billing cycles<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Canceled<\/h3>\n\n\n\n<p>If you&nbsp;<a href=\"https:\/\/developers.braintreepayments.com\/reference\/request\/subscription\/cancel\/ruby\" target=\"_blank\" rel=\"noreferrer noopener\">cancel<\/a>&nbsp;the subscription, the status will be&nbsp;<em>Canceled<\/em>&nbsp;and no further billing will occur.<\/p>\n\n\n\n<p>For more information check out&nbsp;<a href=\"https:\/\/developers.braintreepayments.com\/guides\/recurring-billing\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Braintree\u2019s Developer Guides for Recurring Billing<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>With&nbsp;Braintree Recurring Billing&nbsp;you can easily accept repeat online payments for software, subscription-based businesses, donations, and more.The benefits of using Braintree Recurring Billing for your ecommerce business: Flexible pricing Create custom pricing plans for your customers. Set up discounts, add-ons, promotional periods, and rewards. Prorated subscriptions Your customers have the ability to upgrade or downgrade their [&hellip;]<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_acf_changed":true,"_seopress_robots_primary_cat":"","_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":""},"cpt_integrations_category":[986,990],"class_list":["post-11140","cpt_integrations","type-cpt_integrations","status-publish","hentry","cpt_integrations_category-payment","cpt_integrations_category-subscriptions"],"acf":[],"_links":{"self":[{"href":"https:\/\/spreecommerce.org\/wp-json\/wp\/v2\/cpt_integrations\/11140","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/spreecommerce.org\/wp-json\/wp\/v2\/cpt_integrations"}],"about":[{"href":"https:\/\/spreecommerce.org\/wp-json\/wp\/v2\/types\/cpt_integrations"}],"wp:attachment":[{"href":"https:\/\/spreecommerce.org\/wp-json\/wp\/v2\/media?parent=11140"}],"wp:term":[{"taxonomy":"cpt_integrations_category","embeddable":true,"href":"https:\/\/spreecommerce.org\/wp-json\/wp\/v2\/cpt_integrations_category?post=11140"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}