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:

POST /auth/payload
{ "address": "0xYourWalletAddress" }

Response:

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

Code	Meaning
401	Missing/invalid JWT, or order does not belong to you
404	Order not found
409	Order already paid or otherwise terminal
410	Order expired
422	Validation failed (bad amount/QR, unsupported chain or token, transfer details don’t match the quote) - message is safe to show users
502	Upstream payment provider error - retry later
503	Maintenance mode - read-only operations still work