Lunium — Brazilian PIX and stablecoin payments

 ⟨181 unchanged words⟩ create a second charge for the same intent.

Show the returned image content (when available) and the EXACT qr_copypaste, amount_cents and expires_at. Never shorten or retype the PIX payload. If the host cannot render an inline image, the unchanged copy-and-paste code remains usable. A QR is a payment request, not payment proof. Read hold_hours as well as held/held_hours before promising delivery speed. Track cashin_id with lunium_get_pix_charge; paid alone does not confirm crypto delivery.

Do not create a new charge while a  ⟨89 unchanged words⟩ 

 ⟨36 unchanged words⟩ so they can check without trusting you). AllCOMPLETED fourconfirms the PIX, but receipt links can arrive togetherlater. —If neverreceipt_url constructor thesereceipt_pdf_url URLsis bystill handnull, say the PIX completed and neverthe makereceipt is being prepared; keep polling THIS order at the normal interval, or use cashout.receipt_ready. Never invent a URL or create a second callpayment forto them.obtain a receipt.

Use it after lunium_confirm_crypto_sale and after the crypto ⟨96 unchanged words⟩  wait is the chain's confirmation requirement, sometimes hourshours. MANUAL_REVIEW and uncertain processing are not proof of failure or permission to pay again. AWAITING_REFUND_ADDRESS means a client refund address is needed, REFUNDING_CRYPTO means return in progress, and thereREFUNDED describes the return; show refund_asset, refund_network, refund_amount and refund_tx_hash when available. provider_return_txid alone proves neither PIX payment nor refund to the client. Never reuse deposit_from automatically as a refund destination. sandbox=true is nosimulation, cancel.not a real receipt.

Errors: acao=repetir → poll again. acao=esperar →  ⟨30 unchanged words⟩ 

 ⟨5 unchanged words⟩ the state of a charge created with lunium_create_pix_charge. States:Read pendingBOTH status (unpaidPIX state), under_reviewand settlement_status (PIXcrypto received,delivery). settlementstatus=paid inalone transit),does paidnot (credited,mean crypto released),arrived. delayed,status=paid expiredplus settlement_status=sent reports delivery; settlement_proof=confirmed means the API has chain confirmation evidence. broadcast means a transaction was reported without a recorded confirmation; missing evidence does not prove failure or that the transaction is still unconfirmed. reported means the service reported delivery without confirmation evidence; none means no delivery proof, refundedand simulated is test-only. Show settlement_tx_hash and settlement_tx_url when present, failed.but a hash alone is not confirmation. Never describe sandbox=true as a real payment.

delayed is the state that costs money when ⟨111 unchanged words⟩ 

Step 1 of 3 — price aquote cryptopaying salePIX (commitswith nothing)crypto

Requires an API key. StepPay 1a ofPIX 3key ofor sellingPIX copy-and-paste charge with crypto. Choose ONE mode: amount + pix_key (sell that crypto foramount); reais.brl_amount Prices+ pix_key (quote for a specifictarget BRL amount); ofor abr_code specificalone asset(the charge determines amount and recipient). br_code supports USDT/USDC only, on currently available catalog networks. Key payments use supported catalog assets/networks; never promise every cryptocurrency works. Use the complete, exact copy-and-paste string. If the user provides only an image, use a specificcompatible networkQR againstdecoder; never reconstruct the code with AI. If a specificcharge is refused, do not extract its PIX key, returningand pay it directly: that would be a different payment. Returns amount (crypto to deposit), brl_amount (what the recipient receives), expires_at,  ⟨18 unchanged words⟩ is committed until lunium_confirm_crypto_sale.

Always show the user amount, asset, network, brl_amount and the destination PIX key or merchant_name plus original br_code before confirming. This is the last step where a wrong destination is still free to fix.

For brl_amount, rounding/routing can affect the effective quoted BRL: approve and report the returned amount, not an assumed exact result. For br_code, the returned crypto amount already includes any copia_e_cola_buffer_usd; do not add it again.

Rules that prevent expensive mistakes: send amount as ⟨7 unchanged words⟩ JSON number — floats lose precision in transit. pix_key_typebrl_amount is mandatorya becausedecimal astring CPFin andREAIS, awith phoneat numbermost aretwo bothdecimals 11("100.00" digitsmeans R$100, not cents). With br_code omit amount, brl_amount, pix_key and cannotpix_key_type. pix_key_type is required for ambiguous 11-digit keys; other types can be toldinferred apartby withoutthe it.API. Always send your own external_id: it makes  ⟨70 unchanged words⟩ asset or network you have not confirmed with lunium_list_settlement_options.lunium_list_settlement_options(direction=deposit). Follow pagination and current availability. A catalog listing is not a guarantee that a quote will be accepted; show live limits/fees/expiry.

Errors: acao=corrigir with a limits object →  ⟨65 unchanged words⟩ → this external_id already exists with different parameters; generateinspect acashout_id/recovery_endpoint before any new one,intent. doexternal_id_nao_verificavel notmeans reuse.the legacy order cannot be compared safely; recover that original order instead of creating another payment.

{"additionalProperties":false,"oneOf":[{"not":{"anyOf":[{"required":["brl_amount"]},{"required":["br_code"]}]},"required":["amount","pix_key"]},{"not":{"anyOf":[{"required":["amount"]},{"required":["br_code"]}]},"required":["brl_amount","pix_key"]},{"not":{"anyOf":[{"required":["amount"]},{"required":["brl_amount"]},{"required":["pix_key"]},{"required":["pix_key_type"]}]},"required":["br_code"]}],"properties":{"amount":{"description":"Crypto amountPositive tocrypto sell,amount as a decimal STRING. NeverUse awith JSONpix_key; number.omit when brl_amount or br_code is present.","maxLength":80,"pattern":"^[0-9]+(\\.[0-9]{1 ⟨3 unchanged words⟩ string"},"asset":{"description":"Ticker exactlyfrom aslunium_list_settlement_options(direction=deposit). br_code supports USDT/USDC only.","maxLength":40,"minLength":1,"type":"string"},"br_code":{"description":"Exact PIX copy-and-paste from the user (never abbreviated). Amount and recipient come from it. USDT/USDC only; omit amount, brl_amount, pix_key and pix_key_type.","maxLength":512,"minLength":40,"pattern":"^0002[^\\x00-\\x1f<>|;]+$","type":"string"},"brl_amount":{"description":"Positive target PIX value in REAIS, decimal STRING (100.00 = R$100). Approve the effective 

 ⟨39 unchanged words⟩ funds, wallet, PIX key or credentials needed. RequiresStrongly emailrecommended: email, the e-mail of the person who will test.  ⟨6 unchanged words⟩  invent one; LuniumPay sends the integration guide (what LuniumPay is, manual, flowchart, next steps) to that address once. AWithout missingit orthe invaliddemo still runs and the result's next_step says how to send the e-mail failsafterwards with erro=email_obrigatoriolunium_contact; (acao=corrigir)an beforeinvalid anythinge-mail is created.ignored and reported in email_ignorado. Use one random UUID as request_id and reuse ⟨21 unchanged words⟩ 

 ⟨4 unchanged words⟩ description":"E-mail of the person who will test thetest. API.Strongly Required.recommended: LuniumPay sends them the integration guide (what LuniumPay is, manual, flowchart, next steps) to this address once. Ask the human for it; never invent one. If you do not have it yet, create the key anyway and send it afterwards with lunium_contact.","maxLength":160,"type":"string"} ⟨43 unchanged words⟩ type":"string"}},"required":["request_id","email"],"type":"object"}

 ⟨39 unchanged words⟩ funds, wallet, PIX key or credentials needed. Requires email: the e-mail of the person who will test. Ask them for it and never invent one; LuniumPay sends the integration guide (manual, flowchart, next steps) to that address once. A missing or invalid e-mail fails with erro=email_obrigatorio (acao=corrigir) before anything is created. Use one random UUID as request_id and reuse  ⟨21 unchanged words⟩ 

{"additionalProperties":false,"properties":{"email":{"description":"E-mail of the person who will test the API. Required. LuniumPay sends the integration guide (manual, flowchart, next steps) to this address once. Ask the human for it; never invent one.","maxLength":160,"type":"string"},"flow":{"default":"cashout","enum": ⟨39 unchanged words⟩ type":"string"}},"required":["request_id","email"],"type":"object"}

 ⟨43 unchanged words⟩ to ask your user for credentials.

The key it returns starts with lun_test_ and drives the ENTIRE flow —simulates quotecash-in, acceptcustody, charge,crypto statuswithdrawal, receipt — againstPIX thepayout, sametransfers baseand URLcash-out. andConfirm the same MCPnon-payable endpointtest asPIX production.with NothingPOST settles:/sandbox/cashin/{cashin_id}/pay. noScenarios cryptoand moves,limits: noGET PIX/sandbox. isCatalog paid,and noaccount realdiscovery personare isavailable. charged.For Codea writtendemo againstinside itChatGPT workswith inno productionkey unchangedheaders, because theuse sandboxlunium_start_sandbox_demo emitsand thelunium_get_sandbox_demo. sameNever statessend andfunds theto samea errorsandbox contract.address.

IMPORTANT, tell your user plainly: this is ⟨117 unchanged words⟩ 

Open — no API key needed, so call thisPublic first.catalog Listswith theexplicit assetsdirection and networkspagination. thatdirection=deposit canis settlecrypto-to-PIX right(GET now,/catalog); withdirection=delivery limitsis andPIX/custody-to-crypto expected(GET timing.

Call/cashin/catalog). itFilter beforeby quotingasset/network. wheneverFollow thenext_offset useruntil namesnull; an asset or a network you have not already confirmed in this session. The listomitted changesroute on its own — assets appear and networks getone suspendedpage withoutis noticenot —unsupported. soDelivery neverroutes hard-codereport itwithdrawMin, never cache it across sessionswithdrawFee, never answerminBuyAmount fromand memory.entregavel Polygonwhen (USDT/USDC)provided isby the fastest rail: deposit seen in seconds, PIX typically within 1–2 minutes; everyAPI. otherUse networklive waitspreview for that chain's confirmations, from about a minute to aBRL fewcost; hours.never Neverhard-code promiseminima, "instant"fees or "seconds" for the PIX.

Do not use it to price anything: it carries no rate. Do not offer the userpromise an asset that is absent from this response,deliverable evenmerely ifbecause it worked yesterday.

Errors: acao=repetir → retry once. acao=esperar → you are over the request budget; back off. acao=parar → the connector is not configured; tell the user instead of retrying.listed.

{"additionalProperties":false,"properties":{"networkasset":{"descriptionmaxLength":40,"Optional filtertype":"string"}, e.g. 'polygon'. Omit to list everything settling now."direction":{"default":"deposit","enum":["deposit","delivery"]},"limit":{"maximum":100,"minimum":1,"type":"integer"},"network":{"maxLength":60,"type":"string"},"offset":{"minimum":0,"type":"integer"}},"type":"object"}

 ⟨99 unchanged words⟩  and last four characters.

Call lunium_check_payer_limit first: above the per-payerpayer's ladderinstant canband capthe charge is accepted with a new24 payerh wellprovider belowhold the(held: requestedtrue; amountpaid → delayed → paid), and findingonly outabove R$ 6,000 per day is it refused — knowing beforehand saveslets you tell the user payingwhether intothe acrypto refusal.arrives at once or after the hold. amount_cents is an integer in cents (25000 = ⟨85 unchanged words⟩ call again. acao=esperar → the payer is above theirthe currentR$ ceiling;6,000/day ceiling (or the key opted out of holds); tell the user the maximum that passes now. ⟨7 unchanged words⟩ 

 ⟨20 unchanged words⟩ },"asset":{"default":"usdt","description":"This connector covers USDT/USDC; the REST API delivers any route of GET /cashin/catalog.","enum":["usdt","usdc"]},"chain ⟨2 unchanged words⟩ ","description":"Delivery network. Defaults to polygon. This connector covers USDT/USDC; the REST API delivers any route of GET /cashin/catalog.","type":"string"},"external_id":{ ⟨83 unchanged words⟩ 

Get your own sandbox API key (no signupAPI key required)

 ⟨6 unchanged words⟩ for you, in one call, with no accountprior credentials, no human approval and no money involved.  ⟨158 unchanged words⟩ quote, .04 refuses on limits, .05 runs slowly.slowly, .06 provider compliance refusal, .07 provider instability on first accept (retry works), .08 payer ladder limit.

Errors: erro="limite_de_chaves_teste" (acao=esperar) means this ⟨28 unchanged words⟩ 

 ⟨72 unchanged words⟩ answer from memory. Polygon (USDT/USDC) is the defaultfastest andrail: settlesdeposit seen in seconds;seconds, PIX typically within 1–2 minutes; every other network waits for that chain's confirmations, ⟨4 unchanged words⟩ to a few hours. Never promise "instant" outsideor Polygon."seconds" for the PIX.

Do not use it to price anything:  ⟨50 unchanged words⟩ 

 ⟨71 unchanged words⟩ {"description":"Network id from lunium_list_settlement_options. 'polygon' settlesis the fastest rail (deposit seen in seconds;seconds, PIX typically within 1–2 minutes); anything else waits for that chain's confirmations.", ⟨139 unchanged words⟩