Integrating and customizing the Proxy-Cheap widget on your website [Step by Step Tutorial]

The Proxy-Cheap widget allows resellers and referral partners to embed a proxy-purchasing interface on their websites. This guide explains how to embed the widget and pass supported configuration parameters to Proxy-Cheap checkout.

1. Embed the Proxy-Cheap widget

1.1 Add the stylesheet to `<head>`

Add the following <link> tag inside your website’s <head> section:

<link rel="stylesheet" href="https://main.d30i1txsql53xn.amplifyapp.com/proxy-widget.css">

This stylesheet is required for the widget to display correctly. Use only the official asset URL provided by Proxy-Cheap.

1.2 Insert the widget container

Place the following <div> wherever you want the widget to appear:

<div class="proxy-widget"
     data-language="en"
     data-title="Buy Private Proxies"
     data-subtitle="Fast & Secure Access"
     data-without-title="false"
     data-referrer-code="CODE"
     data-host="https://app.proxy-cheap.com">
</div>

Available attributes:

data-language="en" sets the widget language. The currently documented values are en for English and zh for Chinese.
data-title="Buy Private Proxies" sets the main widget heading.
data-subtitle="Fast & Secure Access" adds a subtitle below the heading.
data-without-title="false" controls whether the title and subtitle are displayed. Set it to true to hide them.
data-referrer-code="CODE" applies your assigned referral code. Remove this attribute if you do not use a referral code.
data-host="https://app.proxy-cheap.com" sets the official Proxy-Cheap checkout host. Keep this value unchanged unless Proxy-Cheap provides another approved host.

You can customize the language, title, subtitle and title visibility. Do not change the checkout host or use unapproved asset URLs.

1.3 Add the script before `</body>`

Add the following script immediately before the closing </body> tag:

<script type="module" src="https://main.d30i1txsql53xn.amplifyapp.com/proxy-widget.es.js"></script>

This script initializes and renders the widget.

Full implementation example

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Proxy-Cheap Widget</title>

    <link rel="stylesheet"
          href="https://main.d30i1txsql53xn.amplifyapp.com/proxy-widget.css">
</head>
<body>

    <div class="proxy-widget"
         data-language="en"
         data-title="Buy Private Proxies"
         data-subtitle="Fast & Secure Access"
         data-without-title="false"
         data-referrer-code="CODE"
         data-host="https://app.proxy-cheap.com">
    </div>

    <script type="module"
            src="https://main.d30i1txsql53xn.amplifyapp.com/proxy-widget.es.js">
    </script>

</body>
</html>

This inserts the Proxy-Cheap widget into your website and directs customers to the official checkout flow.

2. Configure proxy parameters

Configuration parameters can preselect certain options in Proxy-Cheap checkout.

This guide documents parameters for:

Rotating Residential
Rotating Mobile
Static Residential IPv4
Datacenter IPv4
Datacenter IPv6

This guide does not document widget parameters for Static Mobile or Static Residential IPv6. Do not assume that an undocumented product is supported by the widget. Contact Proxy-Cheap Support if you need to integrate another product.

Product availability, locations, ISPs, package sizes, rental periods and pricing can change. The options displayed in the live Proxy-Cheap order form are the current source of truth.

2.1 Rotating Residential and Rotating Mobile

networkType: 'MOBILE' | 'RESIDENTIAL';
bandwidth: number;

`networkType`

MOBILE selects a Rotating Mobile package.
RESIDENTIAL selects a Rotating Residential package.

`bandwidth`

The bandwidth parameter specifies the requested data allocation in gigabytes.

Use the following URL formats:

https://app.proxy-cheap.com/order/checkout?networkType=RESIDENTIAL&bandwidth={BANDWIDTH_GB}

https://app.proxy-cheap.com/order/checkout?networkType=MOBILE&bandwidth={BANDWIDTH_GB}

Replace {BANDWIDTH_GB} with an amount currently accepted by the order form. Availability and final pricing are confirmed during checkout.

2.2 Static Residential IPv4

networkType: 'RESIDENTIAL_STATIC';
isUnusedProxy: boolean;
ipVersion: 'IPv4';
country: string;
isp: string;
quantity: number;
timePeriod: string;

`networkType`

Use RESIDENTIAL_STATIC for Static Residential proxies.

`isUnusedProxy`

This parameter selects the availability or quality option used by the checkout system.

Customer-facing tier names and allocation rules can change. Use the value generated by the current order form rather than assuming that a specific Boolean value always represents a particular product tier.

`ipVersion`

Use IPv4 for the product documented in this section.

`country`

Use the ISO country code shown in the current order form, such as US, DE, FR or GB.

Available countries depend on current inventory. A country appearing in an older example does not guarantee current availability.

`isp`

The ISP must be passed using its current unique ID.

The video below demonstrates how to select an ISP and obtain its current ID from the Proxy-Cheap order form.

Note: The interface and ISP options shown in this video are illustrative and may differ from the current order form.

Always obtain the ISP ID from the live order form when creating a checkout link. Do not copy an ISP ID from an older article, video, or saved URL because availability and internal identifiers can change.

`quantity`

This parameter specifies the requested number of proxies.

`timePeriod`

Use a rental-period value currently offered by the order form. Available periods and discounts can vary.

Checkout URL template

https://app.proxy-cheap.com/order/checkout?networkType=RESIDENTIAL_STATIC&isUnusedProxy={BOOLEAN}&ipVersion=IPv4&country={COUNTRY_CODE}&isp={CURRENT_ISP_ID}&quantity={QUANTITY}&timePeriod={TIME_PERIOD}

Replace every placeholder with a value obtained from the current order form. URL-encode parameter values where required.

2.3 Datacenter IPv4

networkType: 'DATACENTER';
ipVersion: 'IPv4';
country: string;
quantity: number;
timePeriod: string;

`networkType`

Use DATACENTER for Datacenter proxies.

`ipVersion`

Use IPv4 for Datacenter IPv4.

`country`

Use the ISO country code shown in the current order form. Available locations depend on current inventory and should not be taken from a fixed list in this article.

`quantity`

This parameter specifies the requested number of Datacenter IPv4 proxies.

`timePeriod`

Use a rental-period value currently available in checkout.

Checkout URL template

https://app.proxy-cheap.com/order/checkout?networkType=DATACENTER&ipVersion=IPv4&country={COUNTRY_CODE}&quantity={QUANTITY}&timePeriod={TIME_PERIOD}

Replace the placeholders with values accepted by the current order form.

2.4 Datacenter IPv6

networkType: 'DATACENTER';
ipVersion: 'IPv6';
country: string;
package: number;
timePeriod: string;

`networkType`

Use DATACENTER for Datacenter proxies.

`ipVersion`

Use IPv6 for Datacenter IPv6.

`country`

Use an ISO country code currently available for Datacenter IPv6 in the order form. IPv6 availability may differ from IPv4 availability.

`package`

Use a package size currently displayed in checkout. Package sizes can change and should not be hard-coded into an integration without validation.

`timePeriod`

Use a rental-period value currently accepted by checkout.

Checkout URL template

https://app.proxy-cheap.com/order/checkout?networkType=DATACENTER&ipVersion=IPv6&country={COUNTRY_CODE}&package={PACKAGE_SIZE}&timePeriod={TIME_PERIOD}

Replace every placeholder with a currently supported value.

Important checkout information

Widget parameters preselect options but do not guarantee inventory, eligibility, availability or pricing. Customers should review the complete order details before completing payment.

If a URL contains an invalid, unavailable or outdated value, checkout may ignore the parameter or require the customer to select another option.

Test your implementation while logged out and logged in. Confirm that the selected product, location, ISP, quantity, package size and rental period remain correct when checkout opens.

For technical support or custom integration requirements, contact Proxy-Cheap Support.

Search

Proxy-Cheap Help Center

1. Embed the Proxy-Cheap widget

1.1 Add the stylesheet to `<head>`

1.2 Insert the widget container

1.3 Add the script before `</body>`

Full implementation example

2. Configure proxy parameters

2.1 Rotating Residential and Rotating Mobile

`networkType`

`bandwidth`

2.2 Static Residential IPv4

`networkType`

`isUnusedProxy`

`ipVersion`

`country`

`isp`

`quantity`

`timePeriod`

Checkout URL template

2.3 Datacenter IPv4

`networkType`

`ipVersion`

`country`

`quantity`

`timePeriod`

Checkout URL template

2.4 Datacenter IPv6

`networkType`

`ipVersion`

`country`

`package`

`timePeriod`

Checkout URL template

Important checkout information

Search

Proxy-Cheap Help Center

1. Embed the Proxy-Cheap widget

1.1 Add the stylesheet to <head>

1.2 Insert the widget container

1.3 Add the script before </body>

Full implementation example

2. Configure proxy parameters

2.1 Rotating Residential and Rotating Mobile

networkType

bandwidth

2.2 Static Residential IPv4

networkType

isUnusedProxy

ipVersion

country

isp

quantity

timePeriod

Checkout URL template

2.3 Datacenter IPv4

networkType

ipVersion

country

quantity

timePeriod

Checkout URL template

2.4 Datacenter IPv6

networkType

ipVersion

country

package

timePeriod

Checkout URL template

Important checkout information

1.1 Add the stylesheet to `<head>`

1.3 Add the script before `</body>`

`networkType`

`bandwidth`

`networkType`

`isUnusedProxy`

`ipVersion`

`country`

`isp`

`quantity`

`timePeriod`

`networkType`

`ipVersion`

`country`

`quantity`

`timePeriod`

`networkType`

`ipVersion`

`country`

`package`

`timePeriod`