Manage payments

​

View payments

1. 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.
2. 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.

3. Click any payment to open its Payment Details page.

​

Payment details

• 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). It shows CIT for every one-click payment. To see how a one-click payment was sent, check initiation_type in Order meta.
• Order meta: JSON object containing payment context like iteration number, subscription ID, and payment type. Click it to expand. For a one-click payment, it also holds initiation_type (cit or mit), and threeds_challenged when the customer got a 3DS challenge. A one-click payment through Primer can also hold threeds_outcome, threeds_reason_code, saved_method_type, and card_network. Learn more in One-click payment webhooks.

• 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.

​

Manage payments

​

Refunds

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

3. 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.

4. Click Process refund.

​

One-click payment

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

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

​

Customer-initiated (CIT) payments

1. Go to Settings > Main in the FunnelFox Payments dashboard.
2. Set the New Value of one of these settings:
   • one_click_initiation: For the whole organization, for example {"mode":"cit","cit_card_networks":["VISA"]}. An empty cit_card_networks list allows all card brands.
   • funnel_one_click_initiation_overrides: For specific funnels, keyed by funnel ID. A field you leave out keeps the organization value.

3. Click Save, then confirm the change.

{
  "01JQKZ9F7N2XVB6TCDR3M4HW5Y": {
    "mode": "cit",
    "cit_card_networks": ["VISA"]
  }
}

​

One-click payment webhooks

• initiation_type: cit or mit, as the payment was sent to the PSP.
• threeds_outcome: The 3DS outcome of this payment, for example none, frictionless, or challenge_passed.
• threeds_reason_code: The PSP’s raw 3DS reason code, for example CARD_AUTHENTICATION_FAILED. It’s null when the PSP reports none.
• saved_method_type: The saved method that was charged: card, google_pay_pan_only, google_pay_device_token, google_pay_unknown, apple_pay, paypal, or other.
• card_network: The card brand in upper case, for example VISA.
• threeds_required: true unless threeds_outcome is none or skipped.

​

Idempotency

​

Payment method update

​

Metadata

{
  "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 ..."
}

• 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@.

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

​

Billing descriptor

• 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.

​

Email

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

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

• 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.

​

Next steps

• Route payments intelligently across processors
• Learn how payment retries work
• Understand payment tokenization