Set up a payment gateway
This topic describes how to add and configure a payment gateway in Rebilly.
Add a payment gateway
attention
If you are experimenting with the product in the sandbox environment, a test payment gateway called TestProcessor
is configured for all Rebilly accounts.
To complete this process, you must have payment gateway account credentials.
- Log in or sign up to Rebilly .
- Select an environment: In the left navigation bar, in the bottom corner, click your initials and then select Sandbox or Live environment.
-
In the left navigation bar, click
Settings .
- In the Configuration section, click Gateway accounts .
- Click Add Gateway Account .
-
In the list of gateways, select a gateway account.
Use the Search by name field to search for gateways. If the gateway that you require is not listed, Rebilly will integrate it free of charge. For more information, see Gateway integration requests . - In the Gateway Account ID field, enter a unique alphanumeric value. Use a value that is recognizable in your reports. Gateway account IDs are used in other configuration screens, and are also how accounts are referenced within the Rebilly API.
- In the Payment methods section, select the payment methods you want to enable on this payment gateway.
- In the Accepted currencies section, click in the Select currencies field and add one or more currencies.
- In the Setup instruction section, click the Select setup instruction dropdown, and define the setup instruction for new payment instruments.
- Optionally, configure advanced gateway settings. For information on how to set up advanced configurations, see Advanced configuration .
- Click Save gateway account .
- Perform test transactions . For applicable gateways, to test that your credentials are correct, at the top of the screen, click the Check credentials .
Advanced configuration
This section describes how to configure advanced payment gateway account settings.
warning
To use advanced gateway configuration, you must have at least one payment gateway set up in Rebilly. For more information, see Set up a payment gateway.
Enable card statement descriptions
Use this process to assign a name to display on the cardholder's monthly statement, or to use a dynamic descriptor.
A descriptor is the text that is displayed on the cardholder's billing statement. It identifies the source of a credit or debit card transaction. A dynamic descriptor can be modified on a per-transaction basis.
- Optionally, if you are not already in gateway account settings, see Edit a gateway account .
- Scroll to the end of the page, in the Advanced configuration section, turn on the Show advanced configuration slider.
-
In
Card statement description
, select one of the following:
- To assign a name to display on the cardholder's monthly statement: In the Card statement description section, in the Descriptor field, enter the name to display on the monthly statement. In the City field, enter a city.
- To assign a descriptor dynamically: Select the Dynamic descriptor checkbox.
Enable Dynamic Currency Conversion (DCC)
Use this to process to enable DCC on a payment gateway account. DCC detects when a customer is attempting to pay in a currency that is not native to their region, and presents an offer to pay in their native currency at a small markup.
- Optionally, if you are not already in gateway account settings, see Edit a gateway account .
- Scroll to the end of the page, in the Advanced configuration section, turn on the Show advanced configuration slider.
- In the Dynamic currency conversion section, select the Enable Dynamic Currency Conversion checkbox.
- Complete the required fields.
Enable sticky gateway account
Use this process to specify that all future payments from new payment instruments must be processed by the same gateway that processed their first transaction. For more information, see Sticky gateway accounts.
- Optionally, if you are not already in gateway account settings, see Edit a gateway account .
- Scroll to the end of the page, in the Advanced configuration section, turn on the Show advanced configuration slider.
- In the Sticky gateway account section, select the Enable sticky gateway checkbox .
Set gateway account timeout
Use this process to specify that a payment gateway must time out before, or after, its default time out.
- Optionally, if you are not already in gateway account settings, see Edit a gateway account .
- Scroll to the end of the page, in the Advanced configuration section, turn on the Show advanced configuration slider.
- In the Dynamic currency conversion section, select the Enable Dynamic Currency Conversion checkbox.
- In the Gateway account timeout section, enter a value between 10 and 59 seconds.
Set approval window Time To Live (TTL)
Use this process to specify the amount of time in which a suspended transaction must be approved.
- Optionally, if you are not already in gateway account settings, see Edit a gateway account .
- Scroll to the end of the page, in the Advanced configuration section, turn on the Show advanced configuration slider.
- In the Dynamic currency conversion section, select the Enable Dynamic Currency Conversion checkbox.
- In the Approval window TTL section, enter a value, in seconds. Unapproved transactions are abandoned after this period.
Set reconciliation window
Use this process to specify the amount of time in which an approved transaction must be reconciled before it is automatically abandoned.
- Optionally, if you are not already in gateway account settings, see Edit a gateway account .
- Scroll to the end of the page, in the Advanced configuration section, turn on the Show advanced configuration slider.
- In the Dynamic currency conversion section, select the Enable Dynamic Currency Conversion checkbox.
- In the reconciliation window section, select the reconciliation window .
- In the Time window field, enter the reconciliation period, in seconds.
Enable 3D Secure (3DS)
Use this process to enable 3DS transactions on a payment gateway account.
3DS is a security layer for online credit and debit card transactions that is used by merchants to validate cardholders. The cardholder authenticates their card against the website of the issuing bank. The merchant chooses whether to use 3D secure. This enables the merchant to shift liability from themselves to the issuing bank. 3D Secure requires that cardholder interaction. 3D stands for the three domains which interact using the protocol: the merchant or acquirer domain, the issuer domain, and the interoperability domain.
info
To use the Rebilly 3DS provider (3DSecure.io), you must obtain the following merchant information from your acquirer: acquirer Merchant Identification Number (MID) for both Visa and Mastercard, merchant name, acquirer Bank Identification Number (BIN) for Visa (automatic enrollment), acquirer BIN for Mastercard (manual enrollment), merchant country, and merchant URL.
Mastercard enrollment must be initiated by the acquirer. The acquirer must enroll the specific acquirerBIN
and acquirerMerchantID
(for v2) into their system. Enrollment is completed by the acquirer using the Mastercard Connect ISSM tool.
If required, Rebilly can provide all PCI DSS and PCI 3DS certification documentation. For assistance, contact Rebilly support.
- Optionally, if you are not already in gateway account settings, see Edit a gateway account .
- Scroll to the end of the page, in the Advanced configuration section, turn on the Show advanced configuration slider.
- In the 3D Secure section, select the Enable 3D Secure checkbox.
- From the 3D server dropdown, select a server.
- Enter the merchant information you gathered from your acquirer.
- Select a version of 3DS.
- Select a transaction type from the dropdown.
Apply additional filters
Use this process to define additional criteria on when to use a specific payment gateway. For example, to only use a specific payment gateway when the currency is in dollars.
- Optionally, if you are not already in gateway account settings, see Edit a gateway account .
- Scroll to the end of the page, in the Advanced configuration section, turn on the Show advanced configuration slider.
- In the Additional filters section, Click the select filter dropdown, then select an item to filter.
-
Define your filter, and click
Add filter
.
You can add multiple filters. To delete a filter, on the right of the filter, click.
Apply additional reporting
Use this process to add additional reporting and benchmark information to a payment gateway.
- Optionally, if you are not already in gateway account settings, see Edit a gateway account .
- Scroll to the end of the page, in the Advanced configuration section, turn on the Show advanced configuration slider.
- In the Additional information section, in the Acquirer dropdown, select an acquirer company.
- In the Merchant category code dropdown, select a code.
Edit a gateway account
Use this process to access and edit the setting of a payment gateway in Rebilly. For information how to configure advanced settings, see Advanced configuration.
- Log in to Rebilly.
- Select an environment: In the left navigation bar, in the bottom corner, click your initials, then select an environment.
-
In the left navigation bar, click
Settings .
- In the Configuration section, click Gateway accounts .
- In the top right of the screen, click Edit gateway account .
- In the ID column select a gateway account.
Instant payment notifications (IPNs)
IPN is a message service that automatically notifies merchants on transaction events. It is used to automate office administrative functions, including automatically fulfilling orders, and providing customers with order status.
Payment gateways use static or dynamic IPNs. Static IPNs must be configured within the user interface of the gateway, or in some cases, they may need to be set by your account manager. Dynamic IPNs are pre-configured and do not require any further action. If you are unsure whether your payment gateway uses static or dynamic IPNs, contact your gateway account manager.
All static IPNs have the following structure:
https://hook.rebilly.com/ipns/{gatewayName}/{merchantId}