> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supercash.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Resources

> Additional guides and utilities

## Transaction Limits

Every wallet has a payment limit per transaction / per day / per month. This limit is separate for each payment country.\
Daily limit is reset every rolling 24 hours while the monthly limit is reset every calendar month.

Below API returns the caller's per-currency limits with remaining quota:

```bash theme={null}
POST /auth/payload
{ "address": "0xYourWalletAddress" }
```

Response:

```bash theme={null}
{
  "data": {
    "limits": {
      // One entry per supported currency, for the caller's current KYC tier.
      // All amounts carry both a usd and a local value. "remaining" is max
      // minus this user's in-flight and settled orders for the current
      // calendar day / month.
      "VND": {
        "transaction": {
          "min": { "usd": 0.65, "local": 17000 },
          "max": { "usd": 350, "local": 9130000 }
        },
        "daily": {
          "max": { "usd": 4000, "local": 104430000 },
          "remaining": { "usd": 4000, "local": 104430000 }
        },
        "monthly": {
          "max": { "usd": 40000, "local": 1044340000 },
          "remaining": { "usd": 39870, "local": 1040960000 }
        }
      }
    }
  }
}
```

## Error Codes

<table>
  <colgroup>
    <col width="128" />

    <col width="523" />
  </colgroup>

  <thead>
    <tr>
      <th>Code</th>
      <th>Meaning</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>401</td>
      <td>Missing/invalid JWT, or order does not belong to you</td>
    </tr>

    <tr>
      <td>404</td>
      <td>Order not found</td>
    </tr>

    <tr>
      <td>409</td>
      <td>Order already paid or otherwise terminal</td>
    </tr>

    <tr>
      <td>410</td>
      <td>Order expired</td>
    </tr>

    <tr>
      <td>422</td>
      <td>Validation failed (bad amount/QR, unsupported chain or token, transfer details don't match the quote) - `message` is safe to show users</td>
    </tr>

    <tr>
      <td>502</td>
      <td>Upstream payment provider error - retry later</td>
    </tr>

    <tr>
      <td>503</td>
      <td>Maintenance mode - read-only operations still work</td>
    </tr>
  </tbody>
</table>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.