Send a payout

This quickstart walks you through sending your first payout. For detailed implementation, see the full Payouts & B2B documentation.

Overview

Grid’s Payouts API enables you to send money globally across fiat, stablecoins, and Bitcoin. In this quickstart, you’ll:

Set up your platform
Create a customer
Configure accounts
Send your first payment

Prerequisites

A Grid API key (request sandbox access)
Basic understanding of REST APIs

Step 1: Platform Configuration

First, configure your platform settings including supported currencies and payment rails.

Platform Configuration

Learn how to configure your platform settings

Step 2: Create a Customer

Create a customer entity to represent the recipient of your payout.

curl -X POST https://api.lightspark.com/grid/2025-10-13/customers \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "john@example.com"
  }'

Step 3: Configure Accounts

Set up internal and external accounts for the customer.

Internal Accounts

Platform-managed accounts for holding funds

External Accounts

Connect bank accounts for withdrawals

Step 4: Send a Payment

Execute your first payout using a quote.

# Get a quote
curl -X POST https://api.lightspark.com/grid/2025-10-13/quotes \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_currency": "USD",
    "destination_currency": "MXN",
    "amount": "100.00"
  }'

# Execute the payment
curl -X POST https://api.lightspark.com/grid/2025-10-13/transactions \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_id": "QUOTE_ID",
    "customer_id": "CUSTOMER_ID"
  }'