# Resolving Action Required Payments

## Overview

When an incoming bank transfer cannot be automatically matched to an existing order or payment link, the payment enters an "Action Required" state. This guide explains how to identify the type of action required and resolve it.

## Types of Action Required Payments

### Actionable (You Can Resolve These)

These payments show a "Find Matching Payin" button in the top-right corner of the payment details screen.

#### 1. Unmatched Payment (Payin Not Found)

The incoming bank transfer could not be automatically matched to any existing order or payment link. You will see a yellow banner: "Unmatched payment. This incoming bank transfer could not be automatically matched to an existing order or payment link."

![Unmatched payment — Action required screen with Find Matching Payin button](/assets/unmatched-payment.f2f983bf1055f27286a59337294a1b1047c03515fd044ef8326de4ba035834c1.b1ca6591.png)

#### 2. Amount Mismatch

The received amount does not match the original order amount. You will see a yellow banner: "Amount mismatch detected. The received amount does not match the original order amount."

![Amount mismatch — Action required screen](/assets/amount-mismatch.cac121478c096b28f548de54672a60a922b6ab1499302a02b0285f93a687ebc6.b1ca6591.png)

### Non-Actionable (Contact Support)

For all other action required reasons (e.g., additional verification required), you will see a message directing you to contact support@glomopay.com. The "Find Matching Payin" button will not be visible for these cases.

![Non-actionable — Contact support message](/assets/non-actionable-contact-support.25fbcb653ba56eab9daae8a12da5afaa0291ed875e69b3530cbc2300c4d360bc.b1ca6591.png)

## How to Resolve Actionable Payments

### Step 1: Open the Payment Details

Navigate to the payment that is in "Action Required" state. You will see the payment summary, amount, sender details, and the reason for the hold.

### Step 2: Click "Find Matching Payin"

Click the "Find Matching Payin" button in the top-right corner. A dialog will open showing:

- **Left panel** — Incoming payment details: amount, sender name, sender account number, received date, and payment ID.
- **Right panel** — A list of eligible payment links/orders that match the payment amount and currency.


![Match payment to payin dialog showing eligible payins](/assets/match-payment-to-payin-dialog.6241e5046e704ca31fd12862a423f67e4f25627abe37d304a377777e6fe02c65.b1ca6591.png)

### Step 3: Filter Results (If Needed)

If there are many eligible payins, use the filter dropdown and search bar at the top of the dialog to narrow results by:

- **Customer ID** — Filter by exact customer ID
- **Invoice Number** — Filter by invoice number
- **Reference Number** — Filter by reference number


Select the filter type from the dropdown, enter the value, and click Search.

![Filtering eligible payins by invoice number](/assets/filter-eligible-payins.19da0a708a7949122dbea39e6dcd28be0f9ace80023ebbd84e49f67d952c4d6b.b1ca6591.png)

### Step 4: Select a Payin and Review

Choose the correct payment link or order from the list. Each payin card displays the following fields:

- **Payin ID** — The unique identifier for the payment link or order (e.g., `plink_69cb95b0DffDK`).
- **Amount & Currency** — The expected payment amount (e.g., 18.00 USD).
- **Customer Name** — The name of the customer associated with the payin.
- **Email** — The customer's email address.
- **Invoice Number** — The invoice number linked to the payin (e.g., RG12FF590). Displayed if available.
- **Reference Number** — The reference number associated with the payin (e.g., R0001). Displayed if available.
- **Type Badge** — Indicates whether the entry is a Payment link or an Order.


> **Note:** Invoice Number and Reference Number are only shown on the card when they have been provided for that payin. Not all payins will display these fields.


Click "Review Match" to proceed. A review screen will appear showing the payment details and the selected payin side by side. Verify that the details are correct, then click "Confirm Match" to complete the matching.

![Review match screen — Payment and payin details side by side](/assets/review-match-screen.3c1ee3d60b9f9b93c8837423f5a928aab44ec68c52203cdd17005c2e3e312dc7.b1ca6591.png)

## What If No Eligible Payins Are Found?

If the dialog shows "No eligible payment links or orders found", it means there is no active payment link or order with a matching amount for this payment.

![No eligible payment links or orders found](/assets/no-eligible-payins-found.1a0c86a9a48201297b2e28d04ca28ebb6e0e4906534a3f9736238f00b009de8d.b1ca6591.png)

**To resolve this:**

1. Create a new payment link or order with the same amount and currency as the stuck payment.
2. Return to the action required payment.
3. Click "Find Matching Payin" again — the newly created payin will now appear in the eligible list.
4. Select it, review, and confirm the match.