> For the complete documentation index, see [llms.txt](https://docs.toomuchmedia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toomuchmedia.com/getting-started/integrations/supported-billers/rocketgate.md).

# RocketGate

*Article Topics:* [*Billers*](https://docs.toomuchmedia.com/getting-started/common-topics/billers.md)*,* [*Cross Sales*](https://docs.toomuchmedia.com/getting-started/common-topics/cross-sales.md)*,* [*One Click Systems*](https://docs.toomuchmedia.com/getting-started/common-topics/one-click-systems.md)

## Signing up at RocketGate

If you are interested in using RocketGate as a gateway processor please contact them directly:

* URL: [https://www.rocketgate.com](http://www.rocketgate.com/)
* Phone: 702 - 448 - 7367

## Setting up at RocketGate

When setting up at RocketGate, their customer service representatives will need to know your NATS domain. They will use this to setup your postback urls correctly.

Example:

```
https://<NATS domain>/signup/process_rocketgate.php
```

## Setting up in NATS

Due to PCI compliance, Rocketgate as of roughly August 1st 2017 only supports TLS v1.2+ (TLSv1 and v1.1 are no longer supported).

Please ensure your server has at least this version.

### Billers Admin

Go to the [Billers Admin](https://docs.toomuchmedia.com/nats-admin/billers.md), select RocketGate. from the drop-down, and click Add. Enter your Merchant ID, Merchant Password, and optionally your Merchant Account that were provided by RocketGate. Note: RocketGate will need to be added to a cascade before it can be used.

Merchant Account can be set here if you want to use it globally across all sites/options.

You can also check "Enable 3DS" here to send every RocketGate signup through 3D Secure. For more information, see the [3D Secure (3DS)](#3d-secure-3ds) section below.

### Sites Admin

Go to the [Sites Admin](https://docs.toomuchmedia.com/nats-admin/sites.md), edit or create a tour, and go to the Billers tab. Here you will find the following fields for RocketGate:

* Merchant Descriptor (optional) - merchant name to be displayed on cardholder's statement (overrides default descriptor)
* Enable Test Mode - used for testing the integration before doing live transactions. MUST be FALSE when switching live.
* Enable 3DS (optional) - sends signups for this site through RocketGate's 3D Secure flow. See [3D Secure (3DS)](#3d-secure-3ds).
* Merchant Account Override (optional) - similar to Merchant Account from the billers admin. Note: a value here will override the billers admin setting for this site.

Next, Edit (or create) the option(s) you want to use with RocketGate. You will see the following list of available option fields (all preceded by RocketGate id:#):

Currency Type (optional) - the currency that this join option should be billed in. If this is not set, the account default will be used from RocketGate.\
AVS Check - If not set will use the setting at RocketGate. Determines whether address verification should be used for this option.\
CVV2 Check - If not set will use the setting at RocketGate. Determines whether the credit card cvv2 number should be checked for this option.\
Fraud Scrubbing - If not set will use the setting at RocketGate. Determines whether fraud scrubbing should be performed for this option.\
Enable 3DS (optional) - sends signups for this join option through RocketGate's 3D Secure flow. See [3D Secure (3DS)](#3d-secure-3ds).\
Merchant Account Override (optional) - used to send traffic to a different merchant account at RocketGate. Note: This setting will override both site and biller values for this field.<br>

This option setup may also require rules to be setup. You can do so with the purple arrows next to the option row (similar to the several other areas across NATS).

{% hint style="success" %}
**Good to Know:** RocketGate offers support for free trial sign-ups by visitors. To enable this, edit the join option you want to offer free trials for, then fill in the "ROCKETGATE Auth Amount ($0 initial only)" with the authorization amount you wish to use to authorize trial sign-up transactions.
{% endhint %}

### Cross Sales

Go to the [Cross/Up Sales Admin](https://docs.toomuchmedia.com/nats-admin/cross-up-sales.md), click incoming or outgoing cross sales from the navigation tabs (depending on whether you are sending or receiving the cross sale).<br>

For Incoming Cross Sales, go to the Incoming Cross sales section. Add RocketGate from the biller drop down. Fill in the Merchant ID field, may be the same as Merchant ID from the Billers Admin, for this cross sale. You will also want to select the site and program that you want to associate with this cross sale.

Lastly you will fill in the details for this cross sale: Title, Initial price/days, and Recurring price/days.

For Outgoing Cross Sales, go to the Outgoing Cross Sales section. Add RocketGate from the biller drop down. Also in this section, you will fill in the following: Title, Description, and Disclaimer for this cross sale. In the Biller Info you will fill out the data for the receiving end (the person you are doing cross sales with will provide this information for you). Fill in Merchant ID, Merchant Password, Ref Code, Domain, and Currency Type.<br>

{% hint style="info" %}
**Please Note:** If you are sending a cross sale to another NATS customer, you can obtain the biller information for the outgoing cross sale from their NATS install. Login to their NATS install with the account that you want to be credited with the cross sale. Next go to https\://\<other nats domain>/internal.php?page=xsells . You will see the information you need to fill in your admin from this page.
{% endhint %}

## 3D Secure (3DS)

NATS supports RocketGate's Simplified 3DS Flow for initial signups. When 3DS is on, the visitor still enters their card details on your gateway join form, but NATS does not charge the card directly. Instead, it sends the visitor to a RocketGate processing page, which handles 3D Secure verification with the card issuer and then submits the charge.

{% hint style="warning" %}
**Important:** Before turning on 3DS in NATS, contact RocketGate and confirm that:

* 3DS is enabled on your merchant account.
* A HostedPage Postback URL is configured for your merchant account, pointing to `https://<NATS domain>/signup/process_rocketgate.php`. RocketGate's Simplified 3DS Flow is built on their HostedPage system and requires this setting, even if you only use the gateway integration.
  {% endhint %}

### Enabling 3DS

An "Enable 3DS" checkbox is available at three levels, which are the same levels where you can set a Merchant Account:

* **Billers Admin** - turns on 3DS for every signup processed by this RocketGate biller.
* **Sites Admin (Biller Details)** - turns on 3DS for every signup on this site.
* **Join Option** - turns on 3DS for this join option only.

NATS uses 3DS for a signup if the box is checked at any of these levels.

{% hint style="info" %}
**Please Note:** The 3DS checkbox does not work like Merchant Account Override. A lower level cannot turn 3DS off once a higher level has turned it on. For example, if 3DS is enabled in the Billers Admin, every site and join option using that biller will use 3DS. To use 3DS on only some sites or join options, leave it unchecked in the Billers Admin and check it only where you need it.
{% endhint %}

### How the 3DS signup flow works

1. The visitor fills out your gateway join form and submits it.
2. NATS sends the signup details, including the card details, to RocketGate, receives a payment link, and redirects the visitor to it.
3. RocketGate's page runs 3D Secure verification in the visitor's browser and then submits the charge. The visitor does not re-enter their card details, but their card issuer may ask them to complete a challenge (for example, a one-time code or a banking app approval).
4. RocketGate sends the results back and NATS records the transaction and approves the member.
5. RocketGate sends the visitor back to NATS which redirects them to your approval or denial page.

NATS includes the return URLs and the postback URL for successful transactions in each payment link request, using the link domain of the tour the visitor signed up through. RocketGate sends postbacks for failed transactions to the HostedPage Postback URL configured on your account (see the note above).

The 3DS flow also supports free trial join options that use the "Auth Amount ($0 initial only)" field. In that case, NATS requests an authorization from RocketGate instead of a purchase.

If the visitor leaves RocketGate's page without completing payment, NATS does not record a transaction for that signup.

### Cross sales with 3DS

RocketGate's Simplified 3DS Flow does not support pre-checked cross sales, and the initial charge doesn't happen until RocketGate's page finishes. Because of this, NATS cannot charge outgoing cross sales at the moment the join form is submitted. Instead:

1. When the visitor submits the gateway join form, NATS saves the cross sales they selected as **pending**.
2. When RocketGate's postback for the initial (or trial) transaction arrives, NATS records the transaction, then sends the pending cross sales in a background process.
3. Each cross sale is marked as **completed** or **failed** based on RocketGate's response.

If the initial transaction is never completed, the pending cross sales are not sent.

## One Click Systems

### Cancel Membership

Rockgate is one of the billers that supports the Cancel Plus One Click System.

For more information, see our "[Cancel Plus](https://docs.toomuchmedia.com/using-nats/one-click-systems/cancel-plus.md)" page.

### Package Plus

Rocketgate supports the Package Plus feature.

Expired members can also use Package Plus to purchase a new package. They are charged the new package's full price, and a new rebill schedule starts from the purchase. The **Packageplus Prorate** and **Packageplus Upgrade Full Credit** settings don't apply to expired members.

For more information on configuring a package in NATS, please see our "[Package Plus](https://docs.toomuchmedia.com/using-nats/one-click-systems/package-plus.md)" page.

### Token Plus

Rocketgate now support Token Plus feature.

For more information on configuring a token sale in NATS, please see our [Token Plus](https://docs.toomuchmedia.com/using-nats/one-click-systems/token-plus.md) page.

## Additional Support

If you have any further questions regarding the setup of in NATS, please [put in a support ticket](http://clients.toomuchmedia.com/).

You can also review Rocketgate's documentation on configuration settings on their end. <https://support.rocketgate.com/index.php?/Knowledgebase/Article/View/38>

## Additional Settings

* **In Development:** You can set the ROCKETGATE\_STORE\_MERCHANT\_ACCOUNT\_CUSTOM\_FIELD value on the config admin -> billers page to store the RocketGate merchant account value in one of the custom fields in the member record.
* **In Development:** You can set the ROCKETGATE\_CUSTOMERID\_LOOKUP value on the config admin -> billers page to enable member lookup by username, email and billerid. If found, NATS will send the same customerid value to the RocketGate system to create a new subscription under an existing member record. Changing this setting only affects new signups, it is not retroactive. PermitMultipleMemberships option must be enabled at RocketGate in order for this feature to work.
