Requires an API key. Returns how much a specific Brazilian taxpayer (CPF for a person, CNPJ for a company) can move through a PIX charge right now, in cents. Read-only — no charge is created.
Call it before lunium_create_pix_charge whenever the payer is new or the amount is not trivial. Limits are an anti-fraud ladder per taxpayer: a first-time payer starts small and grows with settled history (default API policy: R$ 100 on the first charge, R$ 200 in the first 24 h, then R$ 6,000 per day — read the response, keys can set their own). Above the instant band a charge is still ACCEPTED with a 24 h provider hold (held: true, then delayed) up to R$ 6,000 per day; only above that daily ceiling is it refused. The response gives instant_available_cents (what settles at once) and max_amount_cents (the ceiling, hold included). Checking first turns a surprise hold into a conversation about timing.
Send digits only — no dots, slashes or dashes. Do not use it as a document-validity check, and do not read a high limit as approval: a charge can still be refused for other reasons.
Errors: acao=corrigir → the document is malformed, fix the digits. acao=esperar → quota, retry later with the same input. acao=repetir → transient, retry once. If the returned maximum is below what the user wants, offer that value or a different payer — do not attempt the charge anyway.
ConnectorNo auth