Skip to content

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 saysCheck
"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

WhereWhat you seeWhat to do
Before processingThe project has no permission or contract for the payment method, or the contract misses a fieldFix the permissions or the contract
Fraud preventionDeclined by a Ginger fraud rule or by the fraud providerReview the result: see Fraud prevention
3-D SecureAuthentication failed or was abandonedThe customer retries; check your 3-D Secure rules
Processor or issuerThe processor's or issuer's decline, with its response codeFollow 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.

StepWhat it shows
AuthenticationThe 3-D Secure result
Fraud preventionThe result of the fraud check, with its score, its reason and the integration that checked it
ProcessingThe 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