Manage payments

View all customer transactions, inspect payment details, process refunds, and more in your FunnelFox Payments dashboard.

View payments

You can view all payments in your organization as well as all payments for a specific customer:

Go to the Payments page of your FunnelFox Payments dashboard. To narrow the list, fill in filters such as Order ID, Email, or Status, and click Apply filters.
To see one customer’s payments, find the customer with the search box at the top of the dashboard and open their page. The Payments block shows their latest payments. If they have more, click View all.

Click any payment to open its Payment Details page.

The list includes all subscription payments, as well as one-offs.

Payment details

The Payment Details page shows the order ID under the page title and the total amount charged to the customer at the top. Below, you see:

Payment Method: Card details including masked number, expiration date, card type, and issuer country.
Price Point: The product and price purchased, shown in Order details with its pp_ident.
Primer: The internal payment identifier (pop_payment_id), shown in Order details. It links to the payment in Primer.
Initiated by: Shows whether this is a Customer Initiated Transaction (CIT) or a Merchant Initiated Transaction (MIT).
Order meta: JSON object containing payment context like iteration number, subscription ID, and payment type. Click it to expand.

The Transactions card lists each PSP transaction of the order:

PSP transaction ID: Payment processor’s unique transaction identifier, shown with its status (authorized, settled, etc.).
Transaction ID: The internal identifier FunnelFox Payments assigns to the transaction.
PSP merchant ID: Merchant account identifier used for this transaction.
Amount: Transaction amount and type.
Transaction date: When the PSP processed this transaction.
Created: When FunnelFox Payments recorded this transaction.

A single order may have multiple PSP transactions as it moves through authorization and settlement stages.

FunnelFox Payments allows you to refund any payment or process one-click purchases (like upsells) using securely stored payment credentials.

Refunds

To ensure refunds are processed correctly, initiate them only through the FunnelFox Payments dashboard, Primer, or the FunnelFox Payments API. To process a refund in the dashboard:

Open the payment from the Payments page or from the customer’s page.
Click Refund at the top right. The button appears only for settled payments that still have an amount left to refund.

Configure your refund in the Refund payment dialog:

Amount: Leave it empty to refund everything still refundable.
- If the entire amount is refunded (full refund), the subscription immediately becomes EXPIRED and the one-off payment is revoked.
- If a partial amount is refunded, auto-renewal is disabled automatically.
Reason: Required. Select a reason, such as Customer request or Duplicate payment.
Comment: Optional context for the audit log.
Soft refund: Refunds the payment but keeps auto-renewal enabled. The subscription or one-off remains active.

Click Process refund.

You can also refund a subscription payment from the Payments block on the subscription’s page.

Refunds are limited to 50 attempts per day per organization, and this limit is configurable per merchant.

One-click payment

Once a customer completes a purchase, their payment credentials are securely stored. This allows one-click payments for both one-off and subscription upsells without re-entering details. You can perform one-click payments from the FunnelFox Payments dashboard or using the FunnelFox Payments API.

One-click payments do not use a payment method token, so the two-charge limit per day does not apply.

To process a one-click payment in the dashboard:

Find the customer with the search box at the top of the dashboard and open their page.
Click Charge customer at the top right. The button appears only when the customer has a saved payment method.

Select the price point to upsell under Price point.
Click Charge.

Payment method update

Customers may experience failed payment attempts due to issues with their payment method. FunnelFox Payments lets you redirect customers to the Update payment method page where they can provide a valid payment method. To activate this feature, contact your Solution manager.

Metadata

FunnelFox Payments attaches metadata to every payment request sent to Primer:

{
  "email": "user@example.com",
  "ff_adyen_shop_id_default": "ecom_00000_sub_merchant",
  "ff_country_code": "XX",
  "ff_initiation_type": "cit",
  "ff_org_id": "org_redacted",
  "ff_price_point": "price_redacted",
  "funnelfox": true,
  "ip_address": "ip_redacted",
  "postal_code": "00000",
  "test_client_metadata": "redacted",
  "user_agent": "Mozilla/5.0 ..."
}

By default, FunnelFox Payments includes the customer’s email in the metadata. If the email entered is not valid, it is skipped automatically. An email is valid only if it passes all of the following validation rules:

Must be a properly formatted email address (has a local part, an @ sign, and a valid domain).
Reject if the email ends with example@example.com.
Reject if the email starts with FIXME@.

You can also disable sending email in metadata entirely:

Go to Settings > Main in your FunnelFox Payments dashboard.
Find the include_email_into_primer_request setting and set its New Value to Disabled.
Click Save, then confirm the change.

Billing descriptor

The billing descriptor is the short text FunnelFox Payments sends with a charge, which the bank prints next to the amount on your customer’s card statement. It is also the label shown in the Apple Pay recurring payment sheet. Use a name customers recognize, such as your app or brand rather than your legal entity, for example ACME.COM. A recognizable descriptor reduces disputes opened for unrecognized charges. You can set the descriptor in two places:

Organization default: The statement descriptor setting applies to every price point that has no descriptor of its own.
Price point: The Descriptor field overrides the organization default for that price point.

Where you change the descriptor decides who sees the new text:

Where you change it	New purchases	Renewals of existing subscriptions
Organization default in Settings > Main	Applies immediately to price points without their own descriptor	Applies immediately
Price point Descriptor	Applies immediately	No change. Renewals keep the descriptor the price point carried when it was sold

A descriptor accepts up to 22 characters: letters, digits, spaces, and . , _ ? + / -. Other characters, including apostrophes and &, are rejected and block saving. Once set, FunnelFox Payments sends the descriptor to Primer and to Stripe, where it is the suffix appended to your Stripe account’s own prefix. Adyen, PayPal, Braintree, Checkout.com, and Airwallex take statement text from their own account configuration, so set it there.

Saving a price point with an empty Descriptor stores the current organization default into that price point, so it no longer follows later changes to the default. A price point stays genuinely empty only if it was saved while the organization default was also empty.

Email

When a customer purchases a subscription, FunnelFox Payments stores their email if it was collected in the funnel. To view it:

Find the customer with the search box at the top of the dashboard and open their page.
The email appears in the Customer card, under Email.

You can also collect email automatically from Apple Pay at checkout, without requiring a manual input in the funnel:

Go to Settings > Main in your FunnelFox Payments dashboard.
Find the collect_apple_pay_email setting and set its New Value to Enabled.
Click Save, then confirm the change.

Learn how to update customer emails stored in FunnelFox Payments.

Once enabled:

If email is collected both from a funnel input and from Apple Pay, the Apple Pay email takes priority.
The system keeps both addresses: the secondary email is stored as an alias.
When an Apple Pay email is captured, a user webhook fires with the update_email subtype.
The Apple Pay email is not included in payment metadata. It is available directly in FunnelFox Payments.

This ensures you always have a valid email for your customers, even if they enter a placeholder email in the funnel.

Getting started

FunnelFox Pay

Subscription Billing

Payment orchestration

Revenue recovery

Chargeback prevention

Tax management

Settings

Manage payments