# Lightspark Docs > Lightspark Grid is an API for global payments across fiat, stablecoins, and Bitcoin. This documentation helps developers understand the Grid API and integrate with it. ## Get started ### Overview - [Lightspark Docs](https://docs.lightspark.com/index.md) - [What is Grid?](https://docs.lightspark.com/platform-overview/introduction/what-is-grid.md) - [Capabilities](https://docs.lightspark.com/platform-overview/capabilities.md) - [Use Cases](https://docs.lightspark.com/platform-overview/use-cases.md): Discover what you can build with Grid - [Building with AI](https://docs.lightspark.com/platform-overview/building-with-ai.md): Use AI coding assistants like Claude Code, Cursor, and Codex to explore, build, and debug with the Grid API - [FAQ](https://docs.lightspark.com/platform-overview/introduction/faq.md) ### Core concepts - [Entities & Relationships](https://docs.lightspark.com/platform-overview/core-concepts/entities.md): Understanding Grid's core data model - [Quote System](https://docs.lightspark.com/platform-overview/core-concepts/quote-system.md): How exchange rates, pricing, and payment execution work - [Account Model](https://docs.lightspark.com/platform-overview/core-concepts/account-model.md): Internal accounts, external accounts, and how they work together - [Transaction Lifecycle](https://docs.lightspark.com/platform-overview/core-concepts/transaction-lifecycle.md): Follow a payment from creation to settlement - [Currencies & Payment Rails](https://docs.lightspark.com/platform-overview/core-concepts/currencies-and-rails.md): Supported currencies, countries, and payment methods - [Configuration](https://docs.lightspark.com/platform-overview/configuration.md): Configure your Grid integration ### Strong Customer Authentication - [Strong Customer Authentication](https://docs.lightspark.com/platform-overview/sca/overview.md): How Grid satisfies PSD2 SCA for EU customers - [Per-transaction authorization](https://docs.lightspark.com/platform-overview/sca/per-transaction-authorization.md): Authorize an SCA-gated money movement - [Factor enrollment](https://docs.lightspark.com/platform-overview/sca/factor-enrollment.md): Enroll and manage a customer's TOTP and passkey factors - [Login & sessions](https://docs.lightspark.com/platform-overview/sca/login-and-sessions.md): The end-user SCA login and the session it grants - [Trusted beneficiaries](https://docs.lightspark.com/platform-overview/sca/trusted-beneficiaries.md): Mark an IBAN or USDC address as a known payee - [Two-factor reset](https://docs.lightspark.com/platform-overview/sca/two-factor-reset.md): Recover a customer who has lost their SCA factor ## Build your flow ### Build your flow - [Build your flow](https://docs.lightspark.com/flow-builder.md): Design your flow and get the API calls for your exact use case ## Global Accounts ### Overview - [Playground](https://docs.lightspark.com/global-accounts/demo.md): Create a Global Account and watch the API calls fire in real time - [Global Accounts](https://docs.lightspark.com/global-accounts/index.md): Give your customers a branded, self-custodial multi-currency account powered by Grid. - [Implementation overview](https://docs.lightspark.com/global-accounts/implementation-overview.md): End-to-end walkthrough: create a customer, find their Global Account, register a passkey, fund the account, and execute a signed withdrawal. ### Account security - [Authentication](https://docs.lightspark.com/global-accounts/authentication.md): Register, reauthenticate, and manage Global Account credentials (passkey, OAuth, email OTP) - [Client keys & signing](https://docs.lightspark.com/global-accounts/client-keys.md): Generate the P-256 client key pair, hold the session signing key, and sign account actions on Web, iOS, and Android - [Sessions](https://docs.lightspark.com/global-accounts/managing-sessions.md): List and revoke active sessions on a Global Account - [Exporting a wallet](https://docs.lightspark.com/global-accounts/exporting-wallet.md): Let a customer take the seed of their Global Account off Grid ### Agents (experimental) - [Overview](https://docs.lightspark.com/global-accounts/agents/overview.md): Experimental native Grid functionality for connecting AI agents to Global Accounts with managed policy and approval flows - [Policies & permissions](https://docs.lightspark.com/global-accounts/agents/policies-and-permissions.md): Define bounded agent access for Global Accounts with permissions, limits, restrictions, and approval thresholds - [Approvals & audit](https://docs.lightspark.com/global-accounts/agents/approvals-and-audit.md): Design approval, activity, and revoke experiences for agent-driven Global Account flows - [Claimable payouts](https://docs.lightspark.com/global-accounts/agents/claimable-payouts.md): Let an agent send money to a person by phone number or email, for them to claim from a link ### Platform tools - [Webhooks](https://docs.lightspark.com/global-accounts/platform-tools/webhooks.md): Receive webhook events for funding, withdrawals, and other account state changes on Global Accounts - [Sandbox testing](https://docs.lightspark.com/global-accounts/platform-tools/sandbox-testing.md): Exercise the Global Account auth, signing, and funding flows without standing up real OTP delivery, WebAuthn, or OIDC providers - [Postman Collection](https://docs.lightspark.com/global-accounts/platform-tools/postman-collection.md): Explore the Grid API for Global Accounts using the published Postman collection ## Payouts & B2B ### Overview - [Payouts & B2B](https://docs.lightspark.com/payouts-and-b2b/index.md) - [Core Concepts](https://docs.lightspark.com/payouts-and-b2b/terminology.md): Core concepts and terminology for the Grid API - [Implementation Overview](https://docs.lightspark.com/payouts-and-b2b/onboarding/implementation-overview.md) - [Quickstart](https://docs.lightspark.com/payouts-and-b2b/quickstart.md): Send your first cross-border payment ### Onboarding - [Platform Configuration](https://docs.lightspark.com/payouts-and-b2b/onboarding/platform-configuration.md): Configuring credentials, webhooks and currencies for your platform - [Configuring Customers](https://docs.lightspark.com/payouts-and-b2b/onboarding/configuring-customers.md): Configuring customers for Payouts - [Disclosures](https://docs.lightspark.com/payouts-and-b2b/onboarding/disclosures.md): Expose Lightspark's End User Terms and provide evidence of your consent flow ### Managing accounts - [Internal Accounts](https://docs.lightspark.com/payouts-and-b2b/depositing-funds/internal-accounts.md): Learn how to manage internal accounts for holding platform and customer funds - [Rule-Based Accounts](https://docs.lightspark.com/payouts-and-b2b/depositing-funds/rule-based-accounts.md): Issue dedicated USD account numbers or USDC and USDT deposit addresses that forward every incoming payment to a destination you choose - [External Accounts](https://docs.lightspark.com/payouts-and-b2b/depositing-funds/external-accounts.md): Add and manage external bank accounts, wallets, and payment destinations for withdrawals and payouts - [Required Fields by Corridor](https://docs.lightspark.com/payouts-and-b2b/depositing-funds/required-fields.md): Account and payer fields Grid needs per currency and rail ### Sending payments - [Depositing Funds](https://docs.lightspark.com/payouts-and-b2b/depositing-funds/depositing-funds.md): Depositing funds into internal accounts - [ACH Pull](https://docs.lightspark.com/payouts-and-b2b/depositing-funds/ach-pull.md): Debit a customer's US bank account to fund their Lightspark account - [Sending Payments](https://docs.lightspark.com/payouts-and-b2b/payment-flow/send-payment.md): Learn how to send payments between accounts - [What Recipients See](https://docs.lightspark.com/payouts-and-b2b/payment-flow/recipient-descriptors.md): The sender name and payment reference a recipient sees on their bank statement, by rail and corridor - [Assessing Fees](https://docs.lightspark.com/payouts-and-b2b/payment-flow/assessing-fees.md): Charge your own fee on top of Grid's fees and collect it into your platform account - [List Transactions](https://docs.lightspark.com/payouts-and-b2b/payment-flow/list-transactions.md): Query and filter payment history with powerful filtering and pagination options - [Periodic statements](https://docs.lightspark.com/payouts-and-b2b/payment-flow/statements.md): What a periodic statement for a Grid account contains, and how to build one from Grid transaction data - [Receipts](https://docs.lightspark.com/payouts-and-b2b/payment-flow/receipts.md): Send a compliant receipt to your customer for every completed transaction - [Reconciliation](https://docs.lightspark.com/payouts-and-b2b/payment-flow/reconciliation.md): Match Grid transactions with your internal systems - [Error Handling](https://docs.lightspark.com/payouts-and-b2b/payment-flow/error-handling.md): Handle payment failures, API errors, and transaction issues gracefully ### Global Accounts - [Global Accounts](https://docs.lightspark.com/payouts-and-b2b/global-accounts/overview.md): Self-custody stablecoin accounts that plug into Grid payment flows - [Client keys & signing](https://docs.lightspark.com/payouts-and-b2b/global-accounts/client-keys.md): Generate the P-256 client key pair, hold the session signing key, and sign account actions on Web, iOS, and Android - [Authentication](https://docs.lightspark.com/payouts-and-b2b/global-accounts/authentication.md): Register, reauthenticate, and manage Global Account credentials (passkey, OAuth, email OTP) - [Sessions](https://docs.lightspark.com/payouts-and-b2b/global-accounts/managing-sessions.md): List and revoke active sessions on a Global Account - [Exporting a wallet](https://docs.lightspark.com/payouts-and-b2b/global-accounts/exporting-wallet.md): Let a customer take the seed of their Global Account off Grid ### Platform tools - [Webhooks](https://docs.lightspark.com/payouts-and-b2b/platform-tools/webhooks.md) - [Sandbox Testing](https://docs.lightspark.com/payouts-and-b2b/platform-tools/sandbox-testing.md): Test your payouts integration in the Grid sandbox environment - [Postman Collection](https://docs.lightspark.com/payouts-and-b2b/platform-tools/postman-collection.md) ### Launch - [Launch checklist](https://docs.lightspark.com/payouts-and-b2b/launch/checklist.md): Everything Lightspark reviews before you move from sandbox to production ## Ramps ### Overview - [Ramps](https://docs.lightspark.com/ramps/index.md) - [Core Concepts](https://docs.lightspark.com/ramps/terminology.md): Core concepts and terminology for the Grid API - [Implementation Overview](https://docs.lightspark.com/ramps/onboarding/implementation-overview.md) - [Quickstart](https://docs.lightspark.com/ramps/quickstart.md): Complete guide for converting fiat to crypto (on-ramp) and delivering Bitcoin to a Spark wallet ### Onboarding - [Platform Configuration](https://docs.lightspark.com/ramps/onboarding/platform-configuration.md) - [Configuring Customers](https://docs.lightspark.com/ramps/onboarding/configuring-customers.md): Create and manage customers for ramp conversions ### Managing accounts - [Internal Accounts](https://docs.lightspark.com/ramps/accounts/internal-accounts.md): Manage internal accounts for holding fiat and crypto balances for ramp operations - [External Accounts](https://docs.lightspark.com/ramps/accounts/external-accounts.md): Configure external bank accounts and crypto wallets for ramp destinations ### Conversion flows - [Depositing Funds](https://docs.lightspark.com/ramps/accounts/depositing-funds.md): Depositing funds into internal accounts - [Fiat-to-Crypto and Crypto-to-Fiat](https://docs.lightspark.com/ramps/conversion-flows/fiat-crypto-conversion.md): Build on-ramp and off-ramp flows to convert between fiat currencies and cryptocurrencies - [Self-Custody Wallet Integration](https://docs.lightspark.com/ramps/conversion-flows/self-custody-wallets.md): Send and receive cryptocurrency to and from user-controlled wallets ### Global Accounts - [Global Accounts](https://docs.lightspark.com/ramps/global-accounts/overview.md): Self-custody stablecoin accounts that plug into Grid payment flows - [Client keys & signing](https://docs.lightspark.com/ramps/global-accounts/client-keys.md): Generate the P-256 client key pair, hold the session signing key, and sign account actions on Web, iOS, and Android - [Authentication](https://docs.lightspark.com/ramps/global-accounts/authentication.md): Register, reauthenticate, and manage Global Account credentials (passkey, OAuth, email OTP) - [Sessions](https://docs.lightspark.com/ramps/global-accounts/managing-sessions.md): List and revoke active sessions on a Global Account - [Exporting a wallet](https://docs.lightspark.com/ramps/global-accounts/exporting-wallet.md): Let a customer take the seed of their Global Account off Grid ### Platform tools - [Webhooks](https://docs.lightspark.com/ramps/platform-tools/webhooks.md): Receive real-time notifications for ramp conversions, account updates, and transaction status - [Sandbox Testing](https://docs.lightspark.com/ramps/platform-tools/sandbox-testing.md): Test ramp flows safely without moving real funds - [Postman Collection](https://docs.lightspark.com/ramps/platform-tools/postman-collection.md) ## Global P2P ### Overview - [Global P2P](https://docs.lightspark.com/global-p2p/index.md) - [Core Concepts](https://docs.lightspark.com/global-p2p/terminology.md): Core concepts and terminology for the Grid API - [Implementation Overview](https://docs.lightspark.com/global-p2p/getting-started/implementation-overview.md): High-level implementation plan for configuring, onboarding, funding, and moving money - [Quickstart](https://docs.lightspark.com/global-p2p/quickstart.md): Send your first cross-border payment ### Onboarding - [Platform Configuration](https://docs.lightspark.com/global-p2p/getting-started/platform-configuration.md): Configuring credentials, webhooks and currencies for your platform global P2P payments - [Configuring Customers](https://docs.lightspark.com/global-p2p/onboarding/configuring-customers.md): Creating and managing customers for global P2P payments - [Invitations](https://docs.lightspark.com/global-p2p/onboarding/invitations.md) ### Managing accounts - [Internal Accounts](https://docs.lightspark.com/global-p2p/managing-accounts/internal-accounts.md): Create and manage internal accounts - [External Accounts](https://docs.lightspark.com/global-p2p/managing-accounts/external-accounts.md): Register and manage beneficiary bank accounts ### Sending & receiving payments - [Depositing Funds](https://docs.lightspark.com/global-p2p/sending-receiving-payments/depositing-funds.md): Depositing funds into internal accounts - [Sending Payments](https://docs.lightspark.com/global-p2p/sending-receiving-payments/sending-payments.md) - [Receiving Payments](https://docs.lightspark.com/global-p2p/sending-receiving-payments/receiving-payments.md): Receiving payments from UMA addresses - [Reconciliation](https://docs.lightspark.com/global-p2p/sending-receiving-payments/reconciliation.md): Reconciliation of payments - [Error Handling](https://docs.lightspark.com/global-p2p/sending-receiving-payments/error-handling.md): Handle payment failures, API errors, and transaction issues in Global P2P ### Global Accounts - [Global Accounts](https://docs.lightspark.com/global-p2p/global-accounts/overview.md): Self-custody stablecoin accounts that plug into Grid payment flows - [Client keys & signing](https://docs.lightspark.com/global-p2p/global-accounts/client-keys.md): Generate the P-256 client key pair, hold the session signing key, and sign account actions on Web, iOS, and Android - [Authentication](https://docs.lightspark.com/global-p2p/global-accounts/authentication.md): Register, reauthenticate, and manage Global Account credentials (passkey, OAuth, email OTP) - [Sessions](https://docs.lightspark.com/global-p2p/global-accounts/managing-sessions.md): List and revoke active sessions on a Global Account - [Exporting a wallet](https://docs.lightspark.com/global-p2p/global-accounts/exporting-wallet.md): Let a customer take the seed of their Global Account off Grid ### Platform tools - [Webhooks](https://docs.lightspark.com/global-p2p/platform-tools/webhooks.md): Security best practices for webhook verification - [Sandbox Testing](https://docs.lightspark.com/global-p2p/platform-tools/sandbox-testing.md) - [Postman Collection](https://docs.lightspark.com/global-p2p/platform-tools/postman-collection.md) - [UMA Test Wallet](https://docs.lightspark.com/global-p2p/platform-tools/uma-test-wallet.md): Test UMA payment flows with a real counterparty ## Cards ### Overview - [Playground](https://docs.lightspark.com/cards/demo.md): Issue a branded Visa debit card and watch the API calls fire as you go - [Cards](https://docs.lightspark.com/cards/index.md): Issue debit cards, decision authorizations in real time, and reconcile transactions against internal accounts. - [Terminology](https://docs.lightspark.com/cards/terminology.md): Concepts and resources specific to the Cards API - [Implementation Overview](https://docs.lightspark.com/cards/onboarding/implementation-overview.md): End-to-end architecture for issuing and operating cards - [Quickstart](https://docs.lightspark.com/cards/quickstart.md): Issue your first card and simulate a transaction end to end ### Onboarding - [Cardholder Setup](https://docs.lightspark.com/cards/onboarding/cardholder-setup.md): Prepare a customer to receive a card ### Card management - [Issuing Cards](https://docs.lightspark.com/cards/card-management/issuing-cards.md): Create a virtual card and observe its lifecycle - [Velocity Limits](https://docs.lightspark.com/cards/card-management/velocity-limits.md): Manage card and platform amount and transaction-count limits - [Funding Sources](https://docs.lightspark.com/cards/card-management/funding-sources.md): Bind and update internal accounts as card funding sources - [Embedded Wallet Funding](https://docs.lightspark.com/cards/card-management/embedded-wallet-funding.md): Fund a card from a customer's Embedded Wallet by delegating a signing key to Grid - [Freezing & Closing Cards](https://docs.lightspark.com/cards/card-management/freezing-and-closing.md): Freeze, unfreeze, and close cards via the signed-retry pattern - [Card PINs](https://docs.lightspark.com/cards/card-management/pins.md): Let cardholders set, change, check, and unblock online PINs on cards. - [Digital Wallet Tokenization](https://docs.lightspark.com/cards/card-management/digital-wallet-tokenization.md): Add cards to Apple Pay, Google Pay, and Samsung Pay, manually or from your app ### Transactions - [Reconciliation](https://docs.lightspark.com/cards/transactions/reconciliation.md): How card transactions reconcile, and what exceptions to act on - [Real-time authorization](https://docs.lightspark.com/cards/transactions/real-time-authorization.md): Approve or decline card authorizations from your own endpoint ### Statements - [Periodic statements](https://docs.lightspark.com/cards/statements.md): What a periodic statement for a Grid account contains, and how to build one from Grid transaction data ### Card design - [Card design guidelines](https://docs.lightspark.com/cards/card-design/guidelines.md): Design the front of your card, choose the back's options, and submit artwork for physical cards and digital wallets ### Platform tools - [Webhooks](https://docs.lightspark.com/cards/platform-tools/webhooks.md): Card webhook events and how to consume them - [Sandbox Testing](https://docs.lightspark.com/cards/platform-tools/sandbox-testing.md): Drive deterministic card outcomes with the simulate endpoints ## Changelog ### Changelog - [Changelog](https://docs.lightspark.com/changelog.md): New features, improvements, and updates to the Grid API. - [API reference (270 pages)](https://docs.lightspark.com/_llms/api-reference.txt): Using the API, API documentation. ## OpenAPI Specs - [openapi](/openapi.yaml) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [API reference (270 pages)](https://docs.lightspark.com/_llms/api-reference.txt): Using the API, API documentation. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.