# Centrobill

*Article Topics:* [*Billers*](/getting-started/common-topics/billers.md)*,* [*One Click Systems*](/getting-started/common-topics/one-click-systems.md)*,* [*Up Sales*](/getting-started/common-topics/up-sales.md)*,* [*Cross Sales*](/nats-admin/cross-up-sales/cross-sales.md)

## Setting up at Centrobill

If you wish to become a merchant and accept CENTROBILL as a payment processor, register at [https://centrobill.com/](http://centrobill.com/). They should provide you with an Authorization Key which is needed to setup Centrobill with NATS.

Be sure to configure / have configured the following:

* Successful URL: [https://linkdomain/signup/returnurl\_centrobill.php](http://linkdomain/signup/returnurl_centrobill.php)
* Decline URL: [https://linkdomain/signup/returnurl\_centrobill.php](http://linkdomain/signup/returnurl_centrobill.php)
* IPN URL: [https://linkdomain/signup/process\_centrobill.php](http://linkdomain/signup/process_centrobill.php)

{% hint style="info" %}
**Please Note:** Centrobill supports the "quick sale" API method for upsellplus, packageplus and tokenplus, however you should not setup postback for "quick sale" method on Centrobill's side, otherwise you can run into race conditional issue where a sale can be record with incorrect information.
{% endhint %}

* Please ensure your server IP is whitelisted for access to Centrobill's ip\_list.php

## Setting up Centrobill in NATS

### Billers Admin

To begin setting up Centrobill in NATS, go to the Billers Admin. Scroll down to the "Setup New Biller" drop-down menu, select Centrobill, and click "Add".

{% hint style="info" %}
**Please Note**: If you don't see Centrobill, [put in a support ticket](http://clients.toomuchmedia.com/), as you may need an updated version of NATS.
{% endhint %}

Fill in the *Authorization Key* given to you by Centrobill when prompted, and click Save. If you were not provided with this information, please contact Centrobill. When adding Centrobill to a Cascade, you will have the choice of the following payment methods:

* Credit Card
* Sofort Banking
* SEPA
* iDEAL
* EPS
* Giropay
* Pay Safe Card
* CHECK
* Voucher
* Bancontact
* Poli
* Przelewy24
* crypto
* mobile

### Sites Admin

* There are specific Biller Codes you must enter in the Sites Admin for each join option you create.
  * You can configure you Centrobill Biller codes in the Sites Admin by clicking on "Set Join Options", scroll down to the section labeled "Add New Join Option" and enter the appropriate values for the join option. In the "Biller Codes" section, locate the fields that start with "CENTROBILL". Centrobill will provide you with a Sku Name for each join option you set up with them. Enter this in the CENTROBILL Sku Name field and once you are finished entering all of the join option details, click "Add This Join Option".

### Up Sales and Cross Sales Admin

#### **Incoming Upsell**

To configure an Incoming Upsell with Centrobill, navigate to the Upsells Admin and click the "Incoming Upsells" tab. Select "Centrobill" from the drop-down list of Billers at the bottom of the page. Next, select the site for the upsell and the upsell program and click "Add New Option". You will be prompted to enter the option information for the upsell (initial days, initial amount, rebill days, rebill amount) and the name of the upsell. Fill in this information and the Sku Name provided by Centrobill and click "Save Changes".

#### **Outgoing Upsell**

To configure an Outgoing Upsell with Centrobill, navigate to the Upsells Admin and click the "Outgoing Upsells" tab. Select "Centrobill" from the drop-down list of Billers at the bottom of the page. Next, select the site for the cross sale and the cross sale program and click "Add New Option". In the Details section, enter the Title, Description, and Disclaimer. In the Biller Info section, enter the Sku Name provided by Centrobill. In order to have the Upsale recorded by another program, you need to place the referring code in the Ref Code field. This is required for upsales being recorded in another NATS install. If you are configuring an upsale for a NATS install, this code can be found at \<nats\_domain>/internal.php?page=xsells when logged in as an affiliate that is enabled in the cross sale program. If the incoming upsale is not being processed by your NATS, but another NATS install, provide the domain in the Domain field. Finally, click "Save Changes".

#### **Incoming Cross Sale**

To configure a Incoming Cross sale with Centrobill, navigate to the Upsells Admin and click the "Incoming Cross Sales" tab. Select "Centrobill" from the drop-down list of Billers at the bottom of the page. Next, select the site for the cross sale and the cross sale program and click "Add New Option". You will be prompted to enter the option information for the cross sale (initial days, initial amount, rebill days, rebill amount) and the name of the cross sale. Fill in this information and the Sku Name provided by Centrobill and click "Save Changes".

#### **Outgoing Cross Sale**

To configure an Outgoing Cross Sale with Centrobill, navigate to the Upsells Admin and click the "Outgoing Cross Sales" tab. Select "Centrobill" from the drop-down list of Billers at the bottom of the page. Next, select the site for the cross sale and the cross sale program and click "Add New Option". In the Details section, enter the Title, Description, and Disclaimer. In the Biller Info section, enter the Sku Name provided by Centrobill. In order to have the Cross sale recorded by another program, you need to place the referring code in the Ref Code field. This is required for cross sales being recorded in another NATS install. If you are configuring a cross sale for a NATS install, this code can be found at \<nats\_domain>/internal.php?page=xsells when logged in as an affiliate that is enabled in the cross sale program. Finally, click "Save Changes".

## Token Plus

Centrobill offers support for the Token Plus feature in NATS. This feature allows members of your Token Sites to purchase additional tokens for their account, without requiring them to re-input their payment information to do so. This allows your members to easily buy additional tokens without having to go through any extra steps.

Before you can begin configuring Centrobill to use the Token Plus feature, you must first enable it for the sites you want to offer it on in the Sites Admin. Go to the [Sites Admin](/nats-admin/sites.md), locate the Token Sites that you want to enable this feature on, and click the "Set Join Options" action icon. Edit the join options that you want to enable Token Plus for, then check the "Token Rebuy Allowed" setting here.

For more information on this process, please see our "[Token Plus](/using-nats/one-click-systems/token-plus.md)" page.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toomuchmedia.com/getting-started/integrations/supported-billers/centrobill.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
