Skip to content

Commit 7e4b0dd

Browse files
committed
Address destination schema review feedback
1 parent 8969607 commit 7e4b0dd

13 files changed

Lines changed: 362 additions & 16 deletions

mintlify/global-accounts/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ import Concepts from '/snippets/global-accounts/concepts.mdx';
2525
Give each customer a branded account experience backed by Grid account infrastructure.
2626
</FeatureCard>
2727
<FeatureCard icon="/images/icons/coins.svg" title="Stablecoin balances">
28-
Hold dollar-denominated value and use Grid quotes to move between account balances and supported rails.
28+
Hold dollar-denominated value and use Grid quotes to move between account balances, other Global Accounts, Spark addresses, and supported rails.
2929
</FeatureCard>
3030
<FeatureCard icon="/images/icons/globe.svg" title="Local off-ramps">
3131
Let customers move value to supported local bank rails, including corridors such as PIX, UPI, SEPA, FPS, and more.

mintlify/openapi.yaml

Lines changed: 98 additions & 5 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

mintlify/snippets/global-accounts/walkthrough.mdx

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -360,6 +360,64 @@ curl -X POST "$GRID_BASE_URL/quotes/Quote:019542f5-b3e7-1d02-0000-000000000006/e
360360

361361
The transaction is on its way. You'll receive standard transaction webhooks (`OUTGOING_PAYMENT`) as it settles — see [Transaction lifecycle](/platform-overview/core-concepts/transaction-lifecycle).
362362

363+
## Send to another Global Account or Spark address
364+
365+
Use the same quote and signature flow to send USDB without converting it. Set
366+
the source to the sender's Embedded Wallet account and choose one of these
367+
destinations:
368+
369+
- `ACCOUNT` with another Embedded Wallet's internal account ID.
370+
- `CUSTOMER` with a customer ID on your platform. Grid resolves that
371+
customer's Embedded Wallet account in the source currency.
372+
- `SPARK_ADDRESS` with any compatible Spark address, including a wallet outside
373+
your platform.
374+
375+
The quote returns `payloadToSign` as shown above. Embedded Wallet sources do not
376+
support `immediatelyExecute`; stamp the payload and call
377+
`POST /quotes/{quoteId}/execute`.
378+
379+
<CodeGroup>
380+
```bash Customer ID
381+
curl -X POST "$GRID_BASE_URL/quotes" \
382+
-u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
383+
-H "Content-Type: application/json" \
384+
-H "Idempotency-Key: 33d31868-f45f-4f02-bda0-f57b147e1695" \
385+
-d '{
386+
"source": {
387+
"sourceType": "ACCOUNT",
388+
"accountId": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002"
389+
},
390+
"destination": {
391+
"destinationType": "CUSTOMER",
392+
"customerId": "Customer:019542f5-b3e7-1d02-0000-000000000003"
393+
},
394+
"lockedCurrencySide": "SENDING",
395+
"lockedCurrencyAmount": 10000000,
396+
"description": "Dinner"
397+
}'
398+
```
399+
400+
```bash Spark address
401+
curl -X POST "$GRID_BASE_URL/quotes" \
402+
-u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
403+
-H "Content-Type: application/json" \
404+
-H "Idempotency-Key: d7da1014-6130-43b4-a338-b8f705efdb43" \
405+
-d '{
406+
"source": {
407+
"sourceType": "ACCOUNT",
408+
"accountId": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002"
409+
},
410+
"destination": {
411+
"destinationType": "SPARK_ADDRESS",
412+
"sparkAddress": "spark1pgssyuuuhnrrdjswal5c3s3rafw9w3y5dd4cjy3duxlf7hjzkp0rqx6dj6mrhu"
413+
},
414+
"lockedCurrencySide": "SENDING",
415+
"lockedCurrencyAmount": 10000000,
416+
"description": "Wallet transfer"
417+
}'
418+
```
419+
</CodeGroup>
420+
363421
## Where to next
364422

365423
<CardGroup cols={2}>

0 commit comments

Comments
 (0)