diff --git a/mintlify/platform-overview/core-concepts/quote-system.mdx b/mintlify/platform-overview/core-concepts/quote-system.mdx index 65fb1ad8..e341c5f7 100644 --- a/mintlify/platform-overview/core-concepts/quote-system.mdx +++ b/mintlify/platform-overview/core-concepts/quote-system.mdx @@ -298,6 +298,10 @@ curl -X POST https://api.lightspark.com/grid/2025-10-13/quotes \ - Quote is created and executed in one API call - Best for: Rewards distribution, micro-payments, time-sensitive transfers + +`immediatelyExecute` can only be used for quotes with a source that is either an internal account or has direct pull functionality (e.g., ACH pull with an external account). + + Customer doesn't see rate before execution. If you want to lock a quote and confirm fees and exchange rate details before executing the quote, set `immediatelyExecute` to `false` or omit the field. diff --git a/mintlify/ramps/conversion-flows/fiat-crypto-conversion.mdx b/mintlify/ramps/conversion-flows/fiat-crypto-conversion.mdx index f5622d60..7f79c1ec 100644 --- a/mintlify/ramps/conversion-flows/fiat-crypto-conversion.mdx +++ b/mintlify/ramps/conversion-flows/fiat-crypto-conversion.mdx @@ -210,16 +210,25 @@ app.post("/webhooks/grid", async (req, res) => { ## Immediate execution -For instant on-ramps (e.g., reward payouts), use `immediatelyExecute: true`: +For instant on-ramps (e.g., reward payouts), use `immediatelyExecute: true` with an internal account source: ```javascript const quote = await fetch("https://api.lightspark.com/grid/2025-10-13/quotes", { method: "POST", body: JSON.stringify({ - source: { customerId: "Customer:...", currency: "USD" }, + source: { + sourceType: "ACCOUNT", + accountId: "InternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123", + }, destination: { + destinationType: "EXTERNAL_ACCOUNT_DETAILS", externalAccountDetails: { - /* wallet details */ + customerId: "Customer:...", + currency: "BTC", + accountInfo: { + accountType: "SPARK_WALLET", + address: "spark1...", + }, }, }, lockedCurrencySide: "RECEIVING", @@ -229,6 +238,10 @@ const quote = await fetch("https://api.lightspark.com/grid/2025-10-13/quotes", { }).then((r) => r.json()); ``` + +`immediatelyExecute` can only be used with sources that are either internal accounts or external accounts with direct pull functionality (e.g., ACH pull). + + ## Best practices