Recurly.js

Recurly.js is a browser JavaScript library for securely handling payment details in your own checkout — reducing PCI scope while giving you full control over the user experience.

Recurly.js is a browser JavaScript library that handles your customers' sensitive payment details securely — without exposing that data to your servers. It gives you full control over your checkout's look and feel while keeping your PCI scope to a minimum.

Available on all Recurly plans

1Definition 2Key benefits 3Key details

Prerequisites

Moderate understanding of JavaScript
An active Recurly account
Familiarity with payment gateway integrations

Definition

Recurly.js is a browser JavaScript library that securely transmits payment details from your checkout directly to Recurly's servers — where they're encrypted and stored. In return, your application receives a token you can use for any API operation that requires payment details. You never handle sensitive payment data directly, which keeps your PCI scope significantly reduced.

Key benefits

Reduced PCI scope Payment data goes directly to Recurly — your servers never touch it, significantly reducing your PCI compliance obligations.

Full customizability Build a checkout experience that matches your brand's look and feel — Recurly.js doesn't constrain your UI.

Open source Recurly.js is open-source — view, modify, and contribute to the code on GitHub to adapt it to your needs.

Flexible integration Works alongside other Recurly features and third-party applications without requiring a hosted payment page.

Key details

PCI compliance with Elements

Recurly.js includes Elements — secure payment fields that embed directly into your checkout form. Elements handle the sensitive input on Recurly's infrastructure while remaining visually indistinguishable from your own UI, helping you qualify for reduced PCI scope without sacrificing design control.

How the token flow works

When a customer submits their payment details, Recurly.js transmits that data directly to Recurly — encrypted and stored on Recurly's servers. Your application receives a token in return. Use that token in any Recurly API call that requires payment details. Because your servers never see or store the raw card data, your PCI exposure is minimized.

Developer documentation

For full implementation details, code examples, and integration guidance, see the Recurly.js developer documentation.

Updated 3 days ago

Did this page help you?