Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lumx.io/llms.txt

Use this file to discover all available pages before exploring further.

Transaction limits cap how much a customer can move per transaction, per day, and per month. The level of KYC/B verification a customer goes through determines which limits apply.

Limits

LimitKYC StandardKYC Enhanced*KYB StandardKYB Enhanced*
Per Transaction$7,500$25,000 +$50,000$50,000 +
Daily$15,000$50,000 +$100,000$100,000 +
Monthly$15,000$50,000 +$100,000$100,000 +
*Once a customer finishes Enhanced KYC/KYB, Lumx sets a limit that fits the financial capacity shown in the documents they submitted.

Tracking usage

To track a customer’s limit consumption in real time, pass includeTransactionLimits=true when reading the customer. The response includes used and remaining for both daily and monthly limits, alongside the max per-transaction limit.
Request
curl https://api-sandbox.lumx.io/customers/3c90c3cc-0d44-4b50-8888-8dd25736052a?includeTransactionLimits=true \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "transactionLimits": {
    "single": { "max": "7500.00" },
    "daily": {
      "max": "15000.00",
      "used": "2300.00",
      "remaining": "12700.00"
    },
    "monthly": {
      "max": "15000.00",
      "used": "2300.00",
      "remaining": "12700.00"
    }
  }
}

Requesting higher limits

To unlock higher transaction limits, the customer needs to go through Enhanced KYC/B verification. That runs directly with the Compliance team.

How to request

Limit increase requests are submitted from the Lumx Dashboard, in the customer’s overview page.
  1. Open the customer and click Limit Increase Request.
  2. Enter the new per-transaction, daily, and monthly limits being requested.
  3. Upload a supporting document that justifies the new limits. PDF, JPG, JPEG, or PNG, up to 3 MB.
  4. Submit the request.

Accepted supporting documents

The document has to help Lumx compliance validate the requested limits. Accepted types depend on the customer profile:
Individual customersBusiness customers
Bank statementBank statement
Tax returnFinancial statements
Proof of incomeTax return

Review outcomes

Lumx compliance reviews the document and decides the outcome. The request page shows the current status and a timeline of events. Possible outcomes:
  • Approved: the new limits are granted in full and become active immediately.
  • Partially approved: compliance grants limits below what was requested (e.g. 70,000 USD on a 100,000 USD request) based on what the supporting document justifies. The approved limits become active immediately.
  • Rejected: the new limits aren’t granted. The customer stays on its current limits.
  • RFI: compliance needs additional or corrected documentation before deciding. Resubmit through the same flow.

Review timeline

ServiceTimeline
Limit increase30 minutes to 3 hours
More complex cases (large step-ups, unusual document types, or requests that touch enhanced due diligence) can take longer. Target, not a contractual guarantee.