Advanced gateway configuration

This topic describes how to configure advanced payment gateway account settings.

warning

To use advanced gateway configuration, you must have at least one payment gateway account configured in Rebilly. For more information, see Add gateway account.

Enable card statement descriptions

Use this process to assign a name that will be displayed 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 clearly identifies the source of a credit or debit card transaction. A dynamic descriptor can be modified on a per transaction basis.

  1. Log in to Rebilly.
  2. Select an environment: In the left navigation bar, in the bottom corner, click your initials, then select an environment.
  3. In the left navigation bar, click settings icon Settings , then click Gateway accounts .
  4. In the top right of the screen, click Edit gateway account .
  5. In the ID column select a gateway account.
  6. Scroll to the end of the page, in the Advanced configuration section, enable the Show advanced configuration slider.
  7. In Card statement description , select one of the following:
    • To assign a name that will be displayed 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 to 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.

  1. Log in to Rebilly.
  2. Select an environment: In the left navigation bar, in the bottom corner, click your initials, then select an environment.
  3. In the left navigation bar, click settings icon Settings , then click Gateway accounts .
  4. In the top right of the screen, click Edit gateway account .
  5. In the ID column select a gateway account.
  6. Scroll to the end of the page, in the Advanced configuration section, enable the Show advanced configuration slider.
  7. In the Dynamic currency conversion section, select the Enable Dynamic Currency Conversion checkbox.
  8. Fill in the required fields.

Enable sticky gateway account

Use this process to specify that all subsequent payments, from a payment instrument, will be processed by the same payment gateway account.

  1. Log in to Rebilly.
  2. Select an environment: In the left navigation bar, in the bottom corner, click your initials, then select an environment.
  3. In the left navigation bar, click settings icon Settings , then click Gateway accounts .
  4. In the top right of the screen, click Edit gateway account .
  5. In the ID column select a gateway account.
  6. Scroll to the end of the page, in the Advanced configuration section, enable the Show advanced configuration slider.
  7. 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 account must timeout before, or after, the gateway account's default setting.

  1. Log in to Rebilly.
  2. Select an environment: In the left navigation bar, in the bottom corner, click your initials, then select an environment.
  3. In the left navigation bar, click settings icon Settings , then click Gateway accounts .
  4. In the top right of the screen, click Edit gateway account .
  5. In the ID column select a gateway account.
  6. Scroll to the end of the page, in the Advanced configuration section, enable the Show advanced configuration slider.
  7. In the Dynamic currency conversion section, select the Enable Dynamic Currency Conversion checkbox.
  8. 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.

  1. Log in to Rebilly.
  2. Select an environment: In the left navigation bar, in the bottom corner, click your initials, then select an environment.
  3. In the left navigation bar, click settings icon Settings , then click Gateway accounts .
  4. In the top right of the screen, click Edit gateway account .
  5. In the ID column select a gateway account.
  6. Scroll to the end of the page, in the Advanced configuration section, enable the Show advanced configuration slider.
  7. In the Dynamic currency conversion section, select the Enable Dynamic Currency Conversion checkbox.
  8. In the Approval window TTL section, enter a value, in seconds. Unapproved transactions will be abandoned after this period.

Set reconciliation window

Use this process to specify the amount of time in which an approved transaction can be reconciled before it is automatically abandoned.

  1. Log in to Rebilly.
  2. Select an environment: In the left navigation bar, in the bottom corner, click your initials, then select an environment.
  3. In the left navigation bar, click settings icon Settings , then click Gateway accounts .
  4. In the top right of the screen, click Edit gateway account .
  5. In the ID column select a gateway account.
  6. Scroll to the end of the page, in the Advanced configuration section, enable the Show advanced configuration slider.
  7. In the Dynamic currency conversion section, select the Enable Dynamic Currency Conversion checkbox.
  8. In the reconciliation window section, select the reconciliation window .
  9. 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 an additional security layer for online credit and debit card transactions. 3D stands for the three domains which interact using the protocol: the merchant/acquirer domain, the issuer domain, and the interoperability domain.

info

To use Rebilly's 3DS provider (3DSecure.io), you must obtain the following merchant information from your acquirer: acquirer merchant ID (MID) for both Visa and Mastercard, merchant name, acquirer BIN Visa (automatic enrollment), acquirer BIN 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.

  1. Log in to Rebilly.
  2. Select an environment: In the left navigation bar, in the bottom corner, click your initials, then select an environment.
  3. In the left navigation bar, click settings icon Settings , then click Gateway accounts .
  4. In the top right of the screen, click Edit gateway account .
  5. In the ID column select a gateway account.
  6. Scroll to the end of the page, in the Advanced configuration section, enable the Show advanced configuration slider.
  7. In the 3D Secure section, select the Enable 3D Secure checkbox.
  8. From the 3D server dropdown, select a server.
  9. Enter the merchant information you gathered from your acquirer.
  10. Select a version of 3DS.
  11. Select a transaction type from the dropdown.

Apply additional filters

Use this process to apply additional requirements on when a payment gateway account must be used. For example, to only use a specific payment gateway account when the currency is in dollars.

  1. Log in to Rebilly.
  2. Select an environment: In the left navigation bar, in the bottom corner, click your initials, then select an environment.
  3. In the left navigation bar, click settings icon Settings , then click Gateway accounts .
  4. In the top right of the screen, click Edit gateway account .
  5. In the ID column select a gateway account.
  6. Scroll to the end of the page, in the Advanced configuration section, enable the Show advanced configuration slider.
  7. In the Additional filters section, Click the select filter dropdown, then select an item to filter.
  8. Define your filter, and click Add filter .
    You can add multiple filters. To delete a filter, on the right of the filter, click delete icon .

Apply additional reporting

Use this process to add additional reporting and benchmark information to a payment gateway account.

  1. Log in to Rebilly.
  2. Select an environment: In the left navigation bar, in the bottom corner, click your initials, then select an environment.
  3. In the left navigation bar, click settings icon Settings , then click Gateway accounts .
  4. In the top right of the screen, click Edit gateway account .
  5. In the ID column select a gateway account.
  6. Scroll to the end of the page, in the Advanced configuration section, enable the Show advanced configuration slider.
  7. In the Additional information section, in the Acquirer dropdown, select an acquirer company.
  8. In the Merchant category code dropdown, select a code.