Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion mintlify/global-accounts/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ import Concepts from '/snippets/global-accounts/concepts.mdx';
Give each customer a branded account experience backed by Grid account infrastructure.
</FeatureCard>
<FeatureCard icon="/images/icons/coins.svg" title="Stablecoin balances">
Hold dollar-denominated value and use Grid quotes to move between account balances and supported rails.
Hold dollar-denominated value and use Grid quotes to move between account balances, other Global Accounts, Spark addresses, and supported rails.
</FeatureCard>
<FeatureCard icon="/images/icons/globe.svg" title="Local off-ramps">
Let customers move value to supported local bank rails, including corridors such as PIX, UPI, SEPA, FPS, and more.
Expand Down
103 changes: 98 additions & 5 deletions mintlify/openapi.yaml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

58 changes: 58 additions & 0 deletions mintlify/snippets/global-accounts/walkthrough.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -360,6 +360,64 @@ curl -X POST "$GRID_BASE_URL/quotes/Quote:019542f5-b3e7-1d02-0000-000000000006/e

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).

## Send to another Global Account or Spark address

Use the same quote and signature flow to send USDB without converting it. Set
the source to the sender's Embedded Wallet account and choose one of these
destinations:

- `ACCOUNT` with another Embedded Wallet's internal account ID.
- `CUSTOMER` with a customer ID on your platform. Grid resolves that
customer's Embedded Wallet account in the source currency.
- `SPARK_ADDRESS` with any compatible Spark address, including a wallet outside
your platform.

The quote returns `payloadToSign` as shown above. Embedded Wallet sources do not
support `immediatelyExecute`; stamp the payload and call
`POST /quotes/{quoteId}/execute`.

<CodeGroup>
```bash Customer ID
curl -X POST "$GRID_BASE_URL/quotes" \
-u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 33d31868-f45f-4f02-bda0-f57b147e1695" \
-d '{
"source": {
"sourceType": "ACCOUNT",
"accountId": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002"
},
"destination": {
"destinationType": "CUSTOMER",
"customerId": "Customer:019542f5-b3e7-1d02-0000-000000000003"
},
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 10000000,
"description": "Dinner"
}'
```

```bash Spark address
curl -X POST "$GRID_BASE_URL/quotes" \
-u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: d7da1014-6130-43b4-a338-b8f705efdb43" \
-d '{
"source": {
"sourceType": "ACCOUNT",
"accountId": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002"
},
"destination": {
"destinationType": "SPARK_ADDRESS",
"sparkAddress": "spark1pgssyuuuhnrrdjswal5c3s3rafw9w3y5dd4cjy3duxlf7hjzkp0rqx6dj6mrhu"
},
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 10000000,
"description": "Wallet transfer"
}'
```
</CodeGroup>

## Where to next

<CardGroup cols={2}>
Expand Down
Loading
Loading