Investigate a payment
Find a payment, see why it was declined or stalled, and check what the merchant's systems sent and received.
When a merchant asks about a payment, start in the Admin portal. An order shows the whole history: every payment attempt, the 3-D Secure result, the fraud check, the processor's answer, and every API call and webhook.
Find the payment
Go to Orders in the main menu to search across all merchants, or open the merchant first. Search by date, amount, status, payment method, the merchant's reference or the card number. The search box at the top finds any order by keyword.
From your own systems, use the Search API with the same filters.
Read the order
An order has the tabs General, Order summary, Platform / Browser info, Transactions, API calls and Webhook calls, and a timeline of its statuses. Show JSON shows the order as the API returns it. See Tour the portals.
| The merchant says | Check |
|---|---|
| "The payment was declined" | The transaction: its status error, its reason and Show detail, with the outcome of each step. See See each step of the payment and Error reasons |
| "The customer couldn't authenticate" | The transaction timeline: the 3-D Secure events and their result |
| "The payment is stuck" | The order and transaction statuses: processing waits for the customer or the processor, until the order expires. See Statuses |
| "We didn't get the status" | The Webhook calls tab: the URL, the response of the merchant's server and the retries |
| "Our request failed" | The API calls tab: the request and the response, with the error |
| "The amount on the statement is wrong" | The linked orders: captures, refunds and chargebacks, with their flags |
Why a payment is declined
| Where | What you see | What to do |
|---|---|---|
| Before processing | The project has no permission or contract for the payment method, or the contract misses a field | Fix the permissions or the contract |
| Fraud prevention | Declined by a Ginger fraud rule or by the fraud provider | Review the result: see Fraud prevention |
| 3-D Secure | Authentication failed or was abandoned | The customer retries; check your 3-D Secure rules |
| Processor or issuer | The processor's or issuer's decline, with its response code | Follow the code; soft declines are retried with 3-D Secure where the processor supports it |
See each step of the payment
Open the transaction in the Admin portal. Its Status row shows the status, the reason, and Show detail: the outcome of each step the payment went through, in order.
| Step | What it shows |
|---|---|
| Authentication | The 3-D Secure result |
| Fraud prevention | The result of the fraud check, with its score, its reason and the integration that checked it |
| Processing | The processor's or issuer's answer, with its response code, its description and the merchant advice code |
A step that didn't run isn't shown. For a failed transaction the detail is already open. Merchants see only the status and the reason in the Merchant portal.
Next steps
- Statuses
- Chargebacks and disputes
- Error reasons in the payment acceptance docs