Crear cotización

POSThttps://api.pasarela.melenashair.com/v1/quotes

Calcula cómo se repartiría un depósito con las condiciones actuales de la empresa y cuánto tendría que depositar el usuario para cubrir el gas (to_cover_gas) o para que llegue el monto entero a la tesorería (to_cover_all). No crea ningún cobro ni reserva nada.

Con customer_id, el gas se simula para la dirección de ese cliente: sabe si es su primer depósito (hay que desplegar su contrato) o no.
Sin customer_id, se cotiza el caso más caro: una dirección nueva (first_deposit: true).
Con customer_id y gas_mode distinto de platform, el gas cotizado queda como máximo garantizado durante 15 minutos (gas_guaranteed_until). En cualquier otro caso ese campo es null.
Si gas_mode es platform, gas.fee es "0" y gas.estimate informa lo que le costará a la plataforma.

Si el monto no alcanza para comisiones y gas, la respuesta sigue siendo 200 y el bloque afectado trae { "deposit": "...", "error": "El monto no alcanza para cubrir comisiones y gas" }. Más detalle en Cotizaciones.

Parámetros del cuerpo

tokenstringobligatorio

Símbolo del token: USDT o USDC. No distingue mayúsculas.

amountstringobligatorio

Monto como texto decimal ("100", "25.50"), sin separador de miles ni signo. No puede tener más decimales que el token.

customer_idstring

Cliente para el que se cotiza. Acepta su id, su external_id o ext:<external_id>.

Cabeceras

x-api-keystringobligatorio

Clave de API de la empresa. Se crea y se revoca desde el panel.

Respuestas

1curl --request POST \2 --url 'https://api.pasarela.melenashair.com/v1/quotes' \3 --header 'accept: application/json' \4 --header 'content-type: application/json' \5 --header 'x-api-key: sk_test_…' \6 --data '7{8 "token": "USDT",9 "amount": "100",10 "customer_id": "ext:TARJETA-000123"11}12'

{ "quote": { "token": "USDT", "decimals": 6, "amount": "100", "terms": { "platform_fee_bps": 100, "merchant_fee_bps": 200, "merchant_fee_base": "gross", "gas_paid_by": "customer" }, "gas": { "fee": "0.004691", "estimate": "0.004691", "first_deposit": false, "gas_units": "85051", "gas_price_wei": "20000000", "eth_usd": 2506.55, "eth_usd_source": "chainlink", "buffer_bps": 1000, "cap": "0.5" }, "if_deposit_amount": { "deposit": "100", "platform_fee": "1", "merchant_fee": "2", "gas_fee": "0.004691", "net": "96.995309" }, "to_cover_gas": { "deposit": "100.004691", "platform_fee": "1.000046", "merchant_fee": "2.000093", "gas_fee": "0.004691", "net": "96.999861" }, "to_cover_all": { "deposit": "103.097619", "platform_fee": "1.030976", "merchant_fee": "2.061952", "gas_fee": "0.004691", "net": "100" }, "gas_guaranteed_until": "2026-10-13T15:19:05.271Z" } }