Overview
A Payment Attempt is a single try at charging a card against an invoice. Every attempt — successful or not — is recorded on the Payment Attempts tab, along with the decline reason when a card is refused. This is where you go to understand why a charge didn't go through and to retry it.
Viewing payment attempts
- Open Payments V2 → Payment Attempts.
- Each row is one attempt against an invoice, with a status (for example, succeeded or Failed).
- Click an attempt to open its detail view.
The detail view shows processor information such as the authorization (Auth) code, batch, entry mode, and processor reference — useful when reconciling with MX Merchant or troubleshooting with support.
Understanding a decline
When an attempt fails, the decline reason reported by the card processor is shown on the attempt (and surfaced on failed subscription charges too). Common reasons include an expired card, insufficient funds, or an incorrect card detail. Use the reason to decide what to do next — usually retrying after the patient updates their card, or collecting payment another way.
Retrying a payment
- Open the failed attempt (from the Payment Attempts tab, or from the invoice).
- Choose Retry.
- Confirm the card to use — if the patient has a new card, add or select it first.
- Confirm. If a processing fee applies, the fee is re-calculated and shown on the retry before you submit.
Tip: If the decline was due to a bad or expired card, update the card on file first (see Saving & Managing Cards on File), then retry.
Canceling a payment attempt
If you no longer want a particular attempt to proceed, you can Cancel Payment Attempt.
Careful: Canceling an attempt cannot be undone. It affects only that attempt — the invoice remains and can still be collected another way.
Failed recurring charges
Subscription charges that fail show up here just like one-time charges, with their decline reason. Resolve the card issue and retry the attempt to bring the subscription's invoice current. See Recurring Billing with Subscriptions.