​

Step One: Copy Embeded Code

​

Client Side Implementation

Insert our script tag in your website’s head tag.

<script
  src="https://widget.1price.co/script.js"
  data-1p="YOUR_WORKSPACE_ID"
  defer
></script>

The script needs to be added on your landing page, app, or any other page where you want to use 1Price. This script will add a global variable called $1Price to your window object which will categorize new users.

​

Server Side Implementation

Fetching the 1Price Object

Each time you have a new visitor, you must fetch the 1Price object and store it. We recommend storing it in a cookie for three hours.

GET https://app.1price.co/api/get1PriceObject?workspace_id=&country_code=

Obtaining a country code

We recommend using ipAPI to get the country code of the user.

Re-Validating The Experiment

To prevent duplicate analytics of a customer visting pages or reloading, if you detect a valid cookie, call the following API

GET  https://app.1price.co/api/v1/revalidate_experiment/

​

Step Two: Dynamic Price Number

To have adaptive pricing, change the price value to correspond with the 1Price Experiment. This value will be used during pricing tables within the app and landing page.

fetch("https://widget.1price.co/api/v2/price_value", {
  method: "POST",
  body: JSON.stringify({
    one_price: $1Price,
    unique_id: USER_ID, // OPTIONAL
  }),
})
  .then((response) => response.json())
  .then((data) => {
    console.log("Products", data);
  })
  .catch((error) => {
    console.log(error);
  });

This endpoint returns a JSON object containing pricing details for your products, including monthly and yearly pricing options, and currency information. The response includes:

Success Status

Currency

Product Details

Use this data to dynamically populate your pricing table and ensure your visitors always see the most up-to-date pricing information.

​

$1Price Parameters:

​

Additional parameters include:

​

Step Three: Track Purchases

To determine the success of a experiment, we track multiple data points on Results. Simply add a oneprice_cid to your Stripe Checkout Session

You’ll need to send the 1Price generated priceId to your backend server when creating a Stripe subscription.

const session = await stripe.checkout.sessions.create({
  success_url: "https://example.com/success",
  cancel_url: "https://example.com/cancel",
  metadata: { oneprice_cid: YOUR_1PRICE_CID },
  line_items: [{ price: YOUR_PRICE_ID, quantity: 1 }],
  mode: "subscription",
});

​

Handling Subscription Upgrades

We recommend having your own billing pages given the structure of price experiments. However, for customers who use the Stripe billing portal, our beta /v3/price_value endpoint contains a stripeCheckoutSubscriptionUpdate property.

To retrieve this property simply follow the Step 2 and access the stripeCheckoutSubscriptionUpdate property.

When creating your Stripe portal sessions you will first need to create a custom session. The following is an example of how to create a custom session using the NodeJS library.

const configuration = await stripe.billingPortal.configurations.create({
        features: {
            subscription_update: {
                enabled: true,
                default_allowed_updates: ['price'],
                // The object retrieved from the v3 endpoint
                products: stripeCheckoutSubscriptionUpdate  
            },
        },
        business_profile: {
            privacy_policy_url: 'https://example.com/privacy',
            terms_of_service_url: 'https://example.com/terms',
        },
    })

Once your configuration is made you can create your custom session using the following code.

const session = await stripe.billingPortal.sessions.create({
        customer: stripeCustomerID,
        return_url: req.nextUrl.origin,
        configuration: configuration.id, // The configuration ID you created
    })

​

🧪 ​ Test Integration:

1. Start an experiment on 1Price
   
2. Make a test purchase on your website/app
3. Ensure transaction was tracked on dashboard

BONUS: You can create a 100% off coupon on Stripe and use that code to make the test purchase, so you do not get charged.

​

FAQs

Why do get the error: ‘Start an experiment to activate script’?

This error appears when there are no active experiments in your workspace. To resolve this, go to your dashboard and set at least one experiment’s status to In Progress. The script will automatically activate once you have an active experiment.

What’s the difference between data-1p and workspace_id?

These are two references to the same identifier. data-1p is used when embedding the script tag, while workspace_id is used when accessing it programmatically through $1Price.workspace_id. Both contain the same unique workspace identifier.

Do I need to specify the uniqueId and currency?

The uniqueId parameter is optional and can be used to maintain consistent pricing for a specific customer across multiple sessions. The currency parameter is also optional and can be used to specify the currency for returned pricing values.

How can I preview what a specific customer segment sees?

You can preview the pricing for any offer by making a GET request to:

http://widget.1price.co/api/v2/price_value?offer_id=YOUR_OFFER_ID

This is useful for verifying the pricing that different customer segments will see.

I have additional questions, how can I contact you?

You can always contact us via live chat or email and we can set up a price experiment together!