lunium_quote_crypto_sale

com.luniumpay/pix-brazilian-payments · Verify this server

Requires an API key. Step 1 of 3 of selling crypto for reais. Prices a specific amount of a specific asset on a specific network against a specific PIX key, returning brl_amount (what the recipient receives), expires_at, an order id and a confirmation_token. No money moves and no deposit address is issued here — nothing is committed until lunium_confirm_crypto_sale. Always show the user brl_amount and the destination PIX key before confirming. This is the last step where a wrong destination is still free to fix. Rules that prevent expensive mistakes: send amount as a decimal STRING ("50", "12.5"), never a JSON number — floats lose precision in transit. pix_key_type is mandatory because a CPF and a phone number are both 11 digits and cannot be told apart without it. Always send your own external_id: it makes the call idempotent, so repeating it returns the same order instead of creating a second one, and it is how you recover after a timeout or a crash. Read expires_at from the response instead of assuming a window. Do not call it in a loop to "watch the price" — every call is an order. Do not quote an amount you are not ready to send. Do not quote an asset or network you have not confirmed with lunium_list_settlement_options. Errors: acao=corrigir with a limits object → the value is outside the per-operation range (R$ 5.00 to R$ 50,000.00) or above the daily ceiling, and limits.min_amount / limits.max_amount come back already converted into this asset at this order's rate — use one of those numbers, do not guess. A refusal on the network means it is not settling at this moment: offer another network instead of retrying. acao=esperar → quota. acao=repetir → retry with the SAME external_id. erro="external_id_divergente" (acao=corrigir) → this external_id already exists with different parameters; generate a new one, do not reuse.