Review a held payment

#What Being reviewed means

Railbed received payment evidence that did not pass all the checks needed to confirm the payment normally. One possible reason is that less than the expected amount arrived. Other holds involve the currency, address or transaction evidence.

A hold is a review state in Railbed's record. It does not mean Railbed is holding a balance that you can release from the dashboard. Whether money reached your wallet depends on the evidence for that payment.

#Open the review

1. On Wallet, use the review notice, or open Payments → Being reviewed.
2. Select the payment and read the reason at the top of the drawer.
3. Match the payment ID, amount, currency and reference to the order you expected.
4. Check the settlement details and your payout wallet. Use the available transaction link for a Live payment.
5. Decide your next step based on the reason and the controls Railbed makes available.

A Needs review tag identifies holds that the dashboard allows you to accept. The Payment links → Paid list filter also includes held payments, so that filter alone is not a confirmation that an order should be delivered.

#When Accept as paid is available

For an eligible hold, the drawer offers Accept as paid. Use it only after checking your wallet and deciding that the amount received is sufficient for this order.

The confirmation marks the payment as Paid with what arrived and sends the normal paid notification to connected integrations. That can trigger order fulfilment. It does not charge the customer for a difference, create another transfer or increase the amount in your wallet.

#When the action is unavailable

Some holds cannot be accepted in the dashboard because the evidence does not establish a payment that is safe to accept there. The drawer explains that the money may not have reached your wallet.

Keep the order undelivered while you investigate. When asking for help, include the payment ID, the exact reason shown, the order amount and whether it is Test or Live. Do not send an API key, signing secret, seed phrase or private key.

#Do not top up the original payment

Railbed does not offer a partial-payment top-up flow. Do not ask a buyer to send a difference to the original payment address. If a new payment is needed, make a new request after establishing what already arrived and what the new request is for.

A later valid confirmation can resolve a held payment automatically. Refresh its current status before taking another action, especially if you are returning to an older review.

#Practice before you need it

Create a new Test payment and choose Simulate an underpayment on the simulated provider page. Find the resulting hold, read its details and try the review flow with simulated money. Test and Live mode has the full walkthrough.