> For the complete documentation index, see [llms.txt](https://docs.rip.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rip.xyz/marketplace-guides/payments-and-recovery.md).

# Payments and recovery

Understand payment tokens, deferred proceeds, bid refunds, and recovery.

## Which token pays for each action?

| Action               | Current website                                                               | Contract payment rules                                                       |
| -------------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Fixed-price purchase | Native <code class="expression">space.vars.marketplace\_native\_symbol</code> | Native currency or an allowed ERC20, excluding the wrapped-native token.     |
| Auction bid          | Native <code class="expression">space.vars.marketplace\_native\_symbol</code> | Native currency or an allowed ERC20, excluding the wrapped-native token.     |
| Offer                | <code class="expression">space.vars.marketplace\_wrapped\_symbol</code>       | Wrapped-native token or another allowed ERC20. Native value is not accepted. |
| Gas                  | Native <code class="expression">space.vars.marketplace\_native\_symbol</code> | Required separately for transactions submitted by your wallet.               |

Additional ERC20 payment tokens must have <code class="expression">space.vars.marketplace\_payment\_token\_decimals</code> decimals and exact-transfer behavior. Fee-on-transfer and rebasing tokens are unsupported. A token appearing in contract configuration does not mean the current website exposes it as a trading option. Always inspect the actual order's payment token.

## Native payouts and refunds

The marketplace tries to pay native proceeds and refunds to the recipient with a limited callback gas budget. If the recipient cannot receive that native payment, the contract wraps the amount and attempts delivery as <code class="expression">space.vars.marketplace\_wrapped\_symbol</code>. Check both native and wrapped-token balances before treating a payment as missing. A contract wallet should support receiving wrapped tokens or keep its native receive logic small.

The fallback itself can fail, in which case the transaction reverts. A successful native transfer fallback is a wrapped-token payment, not a deferred ERC20 credit.

## Withdraw a payment credit

If an ERC20 payout cannot be completed, the marketplace can record the full amount as `pendingPayments(token, recipient)`. This can cover sale proceeds, fees, or an outbid or failed-delivery refund. The credited wallet can withdraw to itself or another nonzero address.

1. Connect the wallet that owns the credit on the correct marketplace network.
2. Open **My Profile → Available to withdraw** and select **Refresh balances**.
3. Check the listed token and amount. <code class="expression">space.vars.marketplace\_wrapped\_symbol</code> is checked automatically.
4. Leave **Send to** blank to use your connected wallet, or enter a different valid recipient.
5. Select **Withdraw**, confirm, and wait for a successful receipt.

Only the credited wallet can initiate recovery. Choosing another recipient does not give that recipient permission to initiate it. A failed or canceled withdrawal does not clear the credit.

## Check another payment token

Use **Check another ERC20 token** and enter its contract address. This works for tokens removed from the marketplace allowlist. Additional checked tokens are retained for the browser session. Other tokens are displayed in exact base units; verify their decimals separately before interpreting a human-readable amount.

"No payment credits found" applies only to the tokens checked. It does not prove that every possible token balance is zero. Credits are also specific to the marketplace contract, so check the original deployment if its address has changed.

## Recovery during an outage or pause

The payment-credit card uses direct contract reads and stays available when NFT API or indexer data is unavailable. `withdrawPayment(token, to)` is allowed while marketplace trading is paused and does not require the token to remain on the trading allowlist. A working RPC and functioning token transfers are still required.

Ordinary listing cancellation is also permitted by the reviewed contract while paused, subject to its listing and expiry checks. Offer cancellation, auction cancellation and settlement, new trades, and seller-vault excess withdrawals are blocked by pause. Payment-credit recovery and [seller-vault recovery](https://docs.rip.xyz/marketplace-guides/profile-and-vaults.md#recover-excess-assets) have different permissions and pause behavior.

If a token freezes transfers or blocks every destination you can use, a credit cannot bypass that token's restrictions. Record the transaction hash, original marketplace, token, credited wallet, and error when contacting support.
