{"__v":16,"_id":"56450db898da41190099f32f","category":{"__v":9,"_id":"56450a472c74cf1900da48ca","pages":["56450a5cd608df0d00d26a41","56450c15d608df0d00d26a4b","56450c307f1fff210078e71b","56450ca12229d71700109299","56450db898da41190099f32f","566868be8639090d007593ca","568d55878602880d001ce2c7","568d61106b3c3c0d00838ba4","56d9be54aa96cc150020eb08"],"project":"56450a342229d7170010928a","version":"56450a342229d7170010928d","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-11-12T21:53:11.478Z","from_sync":false,"order":0,"slug":"getting-started","title":"Getting Started"},"parentDoc":null,"project":"56450a342229d7170010928a","user":"55648cf93b87582b003ab8b1","version":{"__v":9,"_id":"56450a342229d7170010928d","project":"56450a342229d7170010928a","createdAt":"2015-11-12T21:52:52.685Z","releaseDate":"2015-11-12T21:52:52.684Z","categories":["56450a352229d7170010928e","56450a472c74cf1900da48ca","565def2677f0090d005819bb","5665dfa0e93ae70d00b96a2a","5665e3db1b6559190020ae8c","5665e47763109d0d0036ba5a","5690123f18c3920d00be8b1c","56944016d8c04d1700e5ae20","569447891005590d0062cace"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"createdAt":"2015-11-12T22:07:52.056Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":4,"body":"# Development Timeframe\n\nDepending on your company resources and timeframe for processing payments, you may want to go live immediately or invest more time to perfect your Recurly implementation. In all cases, an important consideration is your merchant bank account, which can take 1–2 weeks for approval and setup. We recommend kicking off the merchant account application process right away—you can always start work on your Recurly implementation while you await approval.\n\n####Admin Console\nThe Recurly administrative console can be used to manually create subscriptions—perfect for handling orders over the phone or in the field.\n####Hosted Payment Pages\nIndividual subscription plan checkout pages can be created in under 30 minutes.\n####Recurly.js\nRecurly.js forms can be embedded on your website in 1–2 days.\n####API\nDepending on your developer resources, merchants can be up and running with a full API implementation in under a week.\n\n# Technical Skills\n\nRecurly offers different implementation methods for different levels of technical skill, enabling any merchant to quickly start processing payments through our platform.\n\n####Admin Console\nThe admin console does not require any technical expertise. All interactions are handled through an easy-to-use virtual terminal.\n####Hosted Payment Pages\nPerfect for the non-coder, Recurly hosted payment pages are created automatically via the admin interface. They only require sending your customers a link to the hosted page for checkout.\n####Recurly.js\nSlightly more advanced, Recurly.js does require familiarity with APIs and generating HMAC digital signatures. Recurly.js forms are predesigned (but fully customizable), and great for a company who may want a more tailored checkout form without heavy design workload.\n####API\nAny developer familiar with Recurly's client libraries (Ruby, PHP, Python, and .NET) will be able to fully implement using Recurly's API. More advanced developers will be able to work closely with the API to create most any type of billing scenario they desire.\n\n# Look & Feel\n\nThe look and feel of your checkout page is a critical part of your billing—the customer should feel they are making a secure payment directly to your company. In all cases, your customer's credit card statement will reflect your business name.\n\n####Admin Console\nNo customer interaction with Recurly is handled with this implementation option—all actions would be handled by your staff through Recurly's virtual terminal.\n####Hosted Payment Pages\nHosted Pages offer minimal customization—background color and a company logo can be applied. Hosted Pages are hosted by the Recurly servers—the subscribe URL will be hosted at ```:your_subdomain.recurly.com/subscribe/:plan_code```.\n####Recurly.js\nRecurly.js offers the same security as the Hosted Payment Pages, but with a fully customizable pre-built form. Here you can add more advanced CSS, wording, and functionality to match your business look and feel.\n####API\nUsing the Recurly API allows you to fully own the checkout experience. The designs, form creations, and errors are all customizable by your developers.\n\n# Billing Flexibility\n\nRecurly's different implementation options support different billing scenarios—the more advanced your billing scenario, the more likely you'll need to choose an advanced implementation option.\n\n####Admin Console\nThe admin console allows for advanced sign up, including future start dates, extended trials, one-time transactions, and custom pricing plans, all managed by your staff.\n####Hosted Payment Pages\nHosted Pages are meant for simple subscription signup—subscriptions created from a Hosted Page start immediately (or with a trial) and are billed on a regular recurring basis.\n####Recurly.js\nRecurly.js also allows for regular subscription signups and one-time payments.\n####API\nThe Recurly API can be used to create subscription plans with a variety of options such future start dates, custom trials, custom prices, pre-defined quantities. Using the API allows for the most flexibility in your subscription billing scenario.\n\n# PCI Compliance\n\nAs a PCI-DSS Level 1 compliant provider, Recurly can help you meet the PCI Compliance requirements of your merchant bank account. Your level of PCI compliance is determined by one simple test: does your customers' sensitive cardholder data (credit card number, security code) pass through your environment?\n\n####Admin Console\nAll card information is handled directly inside Recurly, making your business eligible for PCI DSS Self-Assessment Questionnaire A.\n####Hosted Payment Pages\nAll card information is handled directly inside Recurly, making your business eligible for PCI DSS Self-Assessment Questionnaire A.\n####Recurly.js\nAll card information is passed directly to Recurly, making your business eligible for PCI DSS Self-Assessment Questionnaire A.\n####API\nCardholder data passes through your system to Recurly. Even if your system only stores credit card data in memory, users submitting credit card data directly via the API are required to complete the PCI DSS Self-Assessment Questionnaire C.\n\n# Customer Management\n\nYour customers will need a place to view their invoice, change their subscription plans, update billing information, or cancel their subscriptions. You may choose to use Recurly's Hosted Account Management Pages with any implementation option for maximum flexibility.\n\n####Admin Console\nYour support staff will be able to use the Recurly admin console to modify customer accounts on their behalf.\n####Hosted Payment Pages\nRecurly offers Hosted Account Management Pages for customers to update their billing information, cancel/reactivate a subscription, or view invoices. Hosted Account Management Pages are not customizable beyond company logo and background color.\n####Recurly.js\nRecurly.js offers a form to update billing information. Any other account actions would need to be handled via another method.\n####API\nThe API can be used to fully implement customer account management into your site. You can also use the ```hosted_login_token``` found on an account to directly log a user into their Hosted Account Management Page—no need for the customer to set a Recurly password!\n\n# Payment Methods\n\nRecurly handles credit card payments for your customers, but can also handle transactions through PayPal (for approved merchants) and 3D Secure, depending on your implementation:\n\n####Admin Console\nThe admin console supports credit card payments.\n####Hosted Payment Pages\nRecurly hosted pages will support PayPal payments and 3D Secure transactions.\n####Recurly.js\nRecurly.js supports credit card payments and PayPal payments.\n\n####API\nThe API supports credit card payments.","excerpt":"Whether you work directly inside our administrative console, choose the quick and easy Hosted Payment Pages, customizable Recurly.js forms, or flexible API integration, Recurly will help manage your customer billing securely. There are a number of options to consider when choosing your implementation method and we'll provide our best advice and merchant experiences below. Please contact our support staff if you'd like to discuss your requirements in more detail.","slug":"integration-paths","type":"basic","title":"Implementing Recurly"}

Implementing Recurly

Whether you work directly inside our administrative console, choose the quick and easy Hosted Payment Pages, customizable Recurly.js forms, or flexible API integration, Recurly will help manage your customer billing securely. There are a number of options to consider when choosing your implementation method and we'll provide our best advice and merchant experiences below. Please contact our support staff if you'd like to discuss your requirements in more detail.

# Development Timeframe Depending on your company resources and timeframe for processing payments, you may want to go live immediately or invest more time to perfect your Recurly implementation. In all cases, an important consideration is your merchant bank account, which can take 1–2 weeks for approval and setup. We recommend kicking off the merchant account application process right away—you can always start work on your Recurly implementation while you await approval. ####Admin Console The Recurly administrative console can be used to manually create subscriptions—perfect for handling orders over the phone or in the field. ####Hosted Payment Pages Individual subscription plan checkout pages can be created in under 30 minutes. ####Recurly.js Recurly.js forms can be embedded on your website in 1–2 days. ####API Depending on your developer resources, merchants can be up and running with a full API implementation in under a week. # Technical Skills Recurly offers different implementation methods for different levels of technical skill, enabling any merchant to quickly start processing payments through our platform. ####Admin Console The admin console does not require any technical expertise. All interactions are handled through an easy-to-use virtual terminal. ####Hosted Payment Pages Perfect for the non-coder, Recurly hosted payment pages are created automatically via the admin interface. They only require sending your customers a link to the hosted page for checkout. ####Recurly.js Slightly more advanced, Recurly.js does require familiarity with APIs and generating HMAC digital signatures. Recurly.js forms are predesigned (but fully customizable), and great for a company who may want a more tailored checkout form without heavy design workload. ####API Any developer familiar with Recurly's client libraries (Ruby, PHP, Python, and .NET) will be able to fully implement using Recurly's API. More advanced developers will be able to work closely with the API to create most any type of billing scenario they desire. # Look & Feel The look and feel of your checkout page is a critical part of your billing—the customer should feel they are making a secure payment directly to your company. In all cases, your customer's credit card statement will reflect your business name. ####Admin Console No customer interaction with Recurly is handled with this implementation option—all actions would be handled by your staff through Recurly's virtual terminal. ####Hosted Payment Pages Hosted Pages offer minimal customization—background color and a company logo can be applied. Hosted Pages are hosted by the Recurly servers—the subscribe URL will be hosted at ```:your_subdomain.recurly.com/subscribe/:plan_code```. ####Recurly.js Recurly.js offers the same security as the Hosted Payment Pages, but with a fully customizable pre-built form. Here you can add more advanced CSS, wording, and functionality to match your business look and feel. ####API Using the Recurly API allows you to fully own the checkout experience. The designs, form creations, and errors are all customizable by your developers. # Billing Flexibility Recurly's different implementation options support different billing scenarios—the more advanced your billing scenario, the more likely you'll need to choose an advanced implementation option. ####Admin Console The admin console allows for advanced sign up, including future start dates, extended trials, one-time transactions, and custom pricing plans, all managed by your staff. ####Hosted Payment Pages Hosted Pages are meant for simple subscription signup—subscriptions created from a Hosted Page start immediately (or with a trial) and are billed on a regular recurring basis. ####Recurly.js Recurly.js also allows for regular subscription signups and one-time payments. ####API The Recurly API can be used to create subscription plans with a variety of options such future start dates, custom trials, custom prices, pre-defined quantities. Using the API allows for the most flexibility in your subscription billing scenario. # PCI Compliance As a PCI-DSS Level 1 compliant provider, Recurly can help you meet the PCI Compliance requirements of your merchant bank account. Your level of PCI compliance is determined by one simple test: does your customers' sensitive cardholder data (credit card number, security code) pass through your environment? ####Admin Console All card information is handled directly inside Recurly, making your business eligible for PCI DSS Self-Assessment Questionnaire A. ####Hosted Payment Pages All card information is handled directly inside Recurly, making your business eligible for PCI DSS Self-Assessment Questionnaire A. ####Recurly.js All card information is passed directly to Recurly, making your business eligible for PCI DSS Self-Assessment Questionnaire A. ####API Cardholder data passes through your system to Recurly. Even if your system only stores credit card data in memory, users submitting credit card data directly via the API are required to complete the PCI DSS Self-Assessment Questionnaire C. # Customer Management Your customers will need a place to view their invoice, change their subscription plans, update billing information, or cancel their subscriptions. You may choose to use Recurly's Hosted Account Management Pages with any implementation option for maximum flexibility. ####Admin Console Your support staff will be able to use the Recurly admin console to modify customer accounts on their behalf. ####Hosted Payment Pages Recurly offers Hosted Account Management Pages for customers to update their billing information, cancel/reactivate a subscription, or view invoices. Hosted Account Management Pages are not customizable beyond company logo and background color. ####Recurly.js Recurly.js offers a form to update billing information. Any other account actions would need to be handled via another method. ####API The API can be used to fully implement customer account management into your site. You can also use the ```hosted_login_token``` found on an account to directly log a user into their Hosted Account Management Page—no need for the customer to set a Recurly password! # Payment Methods Recurly handles credit card payments for your customers, but can also handle transactions through PayPal (for approved merchants) and 3D Secure, depending on your implementation: ####Admin Console The admin console supports credit card payments. ####Hosted Payment Pages Recurly hosted pages will support PayPal payments and 3D Secure transactions. ####Recurly.js Recurly.js supports credit card payments and PayPal payments. ####API The API supports credit card payments.