The transaction dashboard is your central hub for every financial exchange processed through Recurly. Search across all transactions, understand their types and statuses, manage refunds and voids, and investigate fraud — all from one place.

Available on all Recurly plans

1Definition 2Key benefits 3Key details

Prerequisites

An active Recurly account with administrative access
A basic understanding of transaction processes and payment gateway functions

Limitations

Voided transactions cannot be reactivated
Partial refunds cannot be issued on unsettled transactions
Transaction settlement times and fraud checks depend on your third-party payment gateway

Definition

The transaction dashboard in Recurly provides a comprehensive overview of all financial transactions processed through the platform. It includes tools for searching transactions, understanding transaction types and statuses, managing refunds and voids, and performing fraud checks — all designed to streamline the financial management of your customer accounts.

Key benefits

Comprehensive transaction search Find any transaction quickly using a wide range of criteria — from customer details to transaction IDs — so you always have full visibility into your payment activity.

Streamlined refunds and voids Handle unsettled and settled transactions with ease, with intuitive options for voids, full refunds, and partial refunds.

Enhanced fraud management Run built-in fraud checks and complement them with third-party fraud prevention integrations to keep your transactions secure.

Key details

The transaction dashboard gives you a full view of your transaction activity. You can search for transactions using criteria such as UUID, customer name, account code, card digits, card type, gateway reference ID, transaction amount, or currency. Filters let you organize results by transaction type and response, and you can narrow searches further by payment gateway and currency.

Transaction types

Type	Description
Verification	Transactions — usually $0 or $1 — used to verify billing information. These are immediately voided after verification.
Payment	Standard purchases made through Recurly.
Authorization	An Auth-Only purchase made through Recurly using the `/purchases/authorize` endpoint.
Capture	A referenced transaction used to complete an Authorization. Only Authorizations can be captured.
Refund	Transactions where funds were returned following a successful Recurly transaction. Refunds typically occur post-settlement with your gateway.
Void	Transactions where funds were returned following a successful Payment or Authorization prior to settlement (same day). If settlement has already occurred, a Refund is submitted instead.

Transaction statuses

Status	Description
Successful	The transaction was approved by the payment gateway.
Declined	The transaction was not approved by the payment gateway.
Voided	The transaction was canceled before any exchange of funds.
Fraudulent	The transaction was identified as fraudulent.
Pending	The transaction is awaiting completion or further action.
Scheduled	The transaction is set to be processed at a future date.
Processing	The transaction is currently being processed by the payment gateway.
Chargeback	Represents a chargeback on a card or bank/direct debit payment.

Transaction search

You can search for transactions using any of the following fields:

Search field	Description
Account code	Locate transactions tied to a specific Recurly account code.
Company name	Find transactions associated with a company name.
First name	Search transactions by the customer's first name.
Last name	Search transactions by the customer's last name.
Email address	Locate transactions linked to a specific email address.
Username	Find transactions by the username on the customer's account.
Amount	Search for transactions by their amount.
First six digits of the credit card	Locate transactions using the first six digits of a card — useful for identifying the card issuer and type.
Last four digits of the credit card	Narrow down transactions using the last four card digits.
Transaction reference ID	Search using the payment gateway's reference ID.
Transaction UUID	Locate a specific transaction by its unique identifier — the most direct search method available.

Transaction creation

Transactions in Recurly are automatically created when an invoice is processed — triggered by subscription activity (creation, renewal, or modification) or from charges invoiced on an account. To minimize per-transaction gateway fees and reduce the number of separate bank charges for your subscribers, use the Purchase endpoint for both subscription and one-time charge billing. This endpoint consolidates any combination of subscriptions and one-time charges into a single gateway transaction.

Minimum purchase amount

To optimize merchant fees, Recurly doesn't send transactions below $0.03 to your payment gateway. Instead, those invoices are immediately marked as paid. Some payment gateways also enforce their own minimums, typically ranging from $0.30 to $0.50.

Transaction details

Clicking a transaction surfaces its full detail view, organized into two sections.

Transaction details

This section shows the transaction type (payment, refund, authorization, etc.), status (successful, declined, voided), amount, and the customer's billing information, including card type and address details when collected.

Reviewing status details

If a transaction is declined or in an error state, you can investigate further using gateway and internal error codes.

Select the transaction

Open the transaction in question to view its full details.

Review the error codes

Look for gateway error codes or internal error codes in the status details. For a full explanation of each code, see the Recurly API Transaction Errors reference.

Fraud details

This section shows the results of address and CVV verification checks, as well as 3DS Authentication status where performed by the payment gateway. For Fraud Velocity Checks and additional fraud prevention, Recurly recommends partnering with a third-party fraud provider. Contact your Account Executive or Account Manager for more information.

AVS/CVV codes are normalized in Recurly to display both the raw code and a plain-language explanation of the issuer's response. For example, a gateway returning the letter "A" is shown as "Address matches, but the postal code does not match." These codes originate from the card-issuing bank — not from Recurly.

3DS status messages are also normalized to display the final authentication result and applicable metadata. Recurly will always display the final result, even when only partial data is received from the gateway:

Authenticated — the customer successfully verified their identity through 3DS
Attempted — the customer attempted authentication, but the upstream 3DS provider was unavailable or unsupported for the card; the attempt neither failed nor succeeded
Failed — the customer completed authentication but their input was rejected, typically indicating the person attempting the transaction is not the cardholder
Exempted — the customer qualified for Frictionless flow (no challenge) or another exemption, such as a low-value transaction, a low-fraud-rate merchant (TRA), or a trusted merchant listed in the customer's banking app
Error — the 3DS server or provider experienced a hard error and authentication could not continue

Settlement

When a purchase is made, your payment gateway verifies billing information and confirms fund availability through the card processor. On a successful response, funds are reserved and the transaction amount is deducted from the customer's account balance. Transactions are finalized at the end of the day when the gateway processes them for settlement, releasing funds to you as the merchant. A transaction's settlement status determines how voids, refunds, and partial refunds are handled.

Verification

When billing information is added or updated on an account, Recurly issues a $1.00 authorization charge — or a $0.00 verification for gateways that support Zero Dollar Authorizations — to confirm the billing details. This charge is voided once a success or decline response is received from the gateway. Subscription plans with trial periods also process a verification charge at signup to confirm the customer's billing data.

Refunds and voids

Refunding Direct Debit transactionsWait at least one week from the original authorization date before refunding a Direct Debit transaction. Bank transactions are not immediately authorized and can take several days to return as insufficient funds or otherwise unsuccessful. Direct Debit chargebacks are typically non-defensible and can occur well after the initial payment. Only issue refunds to KYC'd customers, and make sure subscribers are aware of bank refund timeframes — otherwise they may also initiate a chargeback, resulting in financial losses.

An unsettled transaction can be voided, which stops it from settling and removes it from the customer's bank statement (timing depends on the individual bank). Once a transaction has settled, it can only be refunded. Because payment gateways have varying settlement processing times, Recurly automatically attempts a void before processing a refund.

Partial refunds can only be issued on settled transactions, so it's advisable to wait 24 hours after an initial transaction before attempting a partial refund. A voided transaction typically disappears from a customer's statement within 24 hours; a refund may take 3–5 business days to appear.

Refunds are always returned to the original payment method — either the credit card or the bank account for ACH payments.

To refund or void a transaction or invoice:

Open the transaction or invoice

Go to the customer's account and select the transaction in the Transactions section, or the invoice in the Invoices section.

Initiate the refund

On the Transaction Details page, select Refund Transaction. On the Invoice Details page, select Refund Invoice.

Select the items to refund

Choose the specific charge line items, with options to prorate subscription charges or select specific quantities. For a custom amount, select "Refund a partial item or specific amount?" — the amount cannot exceed the original transaction value. Unsettled transactions can only be fully refunded (voided).

Set the credit return order (partial refunds only)

If the invoice includes credit line items and you're issuing a partial refund, choose whether to return credit to the account first or issue money back to the customer first. By default, Recurly returns credit to the account first. Adjust this using the radio buttons at the top of the page.

Preview the refund

Select Preview Refund to review the refund details, including any discounts, taxes, and credit being returned.

Complete the refund

Select Refund Charges to finalize. Recurly generates a refund invoice and transaction. Learn more in the Invoices section.