---
updatedAt: 2026-07-07T21:54:59.000Z
agentTools:
  siteIndex: https://docs.recurly.com/llms.txt
  projectIndex: https://docs.recurly.com/recurly-subscriptions/llms.txt
---

# How to test your gateway

Validate your Recurly payment gateway configuration by running a test transaction in development or production mode before going live.

<div class="rp-page">
  <div class="rp-overview">Before going live, run a test transaction to confirm your payment gateway is communicating correctly with Recurly. Testing is available in development mode and production mode — sandbox mode is not supported.</div>
  <div class="rp-plan"><i class="fa-solid fa-key" aria-hidden="true"></i> Available on all Recurly plans</div>
  <div class="rp-toc">
    <a class="rp-toc-pill" href="#definition"><span class="rp-toc-num">1</span>Definition</a>
    <a class="rp-toc-pill" href="#test-your-gateway-configuration"><span class="rp-toc-num">2</span>Test your gateway configuration</a>
  </div>
</div>

### Prerequisites

<ul class="rp-list">
  <li>A Recurly account set to development or production mode.</li>
  <li>A payment gateway configured in Recurly.</li>
</ul>

# Definition

<div class="rp-definition">Recurly's gateway test configuration tool lets merchants verify that their payment gateway is correctly integrated and able to process transactions before going live. Testing requires your site to be in development or production mode — it is not available in sandbox mode.</div>

# Test your gateway configuration

<div class="rp-steps">
  <div class="rp-step">
    <div class="rp-step-num">1</div>
    <div><h4>Open Test Configuration</h4><p>In Recurly, navigate to <strong>Configuration → Payment Gateways</strong>. Locate your gateway, click <strong>Options</strong> in the upper right, and select <strong>Test Configuration</strong>.</p></div>
  </div>
  <div class="rp-step">
    <div class="rp-step-num">2</div>
    <div><h4>Review the results</h4><p>A successful test confirms that Recurly can communicate with your payment gateway and is ready to process transactions. If the test fails, check your gateway credentials and configuration settings.</p></div>
  </div>
</div>

<br />

# Sibling pages

* [Payment gateway & merchant account overview](https://docs.recurly.com/recurly-subscriptions/docs/gateway-merchant-account-overview.md)
* [Gateways & payment methods configuration](https://docs.recurly.com/recurly-subscriptions/docs/payment-gateways.md)
* [Multiple gateway configuration](https://docs.recurly.com/recurly-subscriptions/docs/gateway-configuration.md)
* [Gateways and token support](https://docs.recurly.com/recurly-subscriptions/docs/gateway-token-support.md)
* [Custom gateway routing ](https://docs.recurly.com/recurly-subscriptions/docs/custom-gateway-routing-configuration.md)
* [Gateway failover](https://docs.recurly.com/recurly-subscriptions/docs/gateway-failover.md)
* [NACHA verification](https://docs.recurly.com/recurly-subscriptions/docs/nacha-verification.md)
* [Currency support](https://docs.recurly.com/recurly-subscriptions/docs/currency-support-by-gateway.md)
* [Fraud management](https://docs.recurly.com/recurly-subscriptions/docs/fraud-management.md)
* [Chargeback management for cards](https://docs.recurly.com/recurly-subscriptions/docs/chargeback-management-for-cards.md)
* [Payment descriptors](https://docs.recurly.com/recurly-subscriptions/docs/payment-descriptors.md)
* [Gateway specific information for invoice numbers](https://docs.recurly.com/recurly-subscriptions/docs/gateway-specific-information-for-invoice-numbers.md)
* [Direct debit retries](https://docs.recurly.com/recurly-subscriptions/docs/sepa-retries.md)
* [Test gateway](https://docs.recurly.com/recurly-subscriptions/docs/test.md)