Skip to main content
POST
/
smart-accounts
/
{smart_account_address}
/
payment-intents
cURL
curl --request POST \
  --url https://grid.squads.xyz/api/v0/grid/smart-accounts/{smart_account_address}/payment-intents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Grid-Environment: <x-grid-environment>' \
  --data '
{
  "amount": "<string>",
  "destination": {
    "currency": "usd",
    "details": {
      "account_owner_name": "<string>",
      "address": {
        "city": "<string>",
        "country": "<string>",
        "state": "<string>",
        "street_line_1": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>"
      },
      "idempotency_key": "<string>",
      "account": "<unknown>",
      "account_number": "<string>",
      "account_owner_type": "<unknown>",
      "account_type": "<unknown>",
      "bank_name": "<string>",
      "business_name": "<string>",
      "currency": "<unknown>",
      "first_name": "<string>",
      "iban": "<unknown>",
      "last_name": "<string>",
      "routing_number": "<string>",
      "swift": "<unknown>"
    },
    "payment_rail": "ach"
  },
  "grid_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source": {
    "currency": "usd",
    "details": {
      "account_owner_name": "<string>",
      "address": {
        "city": "<string>",
        "country": "<string>",
        "state": "<string>",
        "street_line_1": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>"
      },
      "idempotency_key": "<string>",
      "account": "<unknown>",
      "account_number": "<string>",
      "account_owner_type": "<unknown>",
      "account_type": "<unknown>",
      "bank_name": "<string>",
      "business_name": "<string>",
      "currency": "<unknown>",
      "first_name": "<string>",
      "iban": "<unknown>",
      "last_name": "<string>",
      "routing_number": "<string>",
      "swift": "<unknown>"
    },
    "payment_rail": "ach"
  },
  "webhook_url": "<string>"
}
'
{
  "amount": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "currency": "usd",
  "destination": {
    "currency": "usd",
    "payment_rail": "ach",
    "ach_reference": "<string>",
    "blockchain_memo": "<string>",
    "bridge_wallet_id": "<string>",
    "external_account_id": "<string>",
    "from_address": "<string>",
    "imad": "<string>",
    "omad": "<string>",
    "sepa_reference": "<string>",
    "swift_charges": "<string>",
    "swift_reference": "<string>",
    "to_address": "<string>",
    "trace_number": "<string>",
    "uetr": "<string>",
    "wire_message": "<string>"
  },
  "id": "<string>",
  "payment_rail": "ach",
  "source": {
    "currency": "usd",
    "payment_rail": "ach",
    "bank_beneficiary_address": "<string>",
    "bank_beneficiary_name": "<string>",
    "bank_name": "<string>",
    "bank_routing_number": "<string>",
    "bridge_wallet_id": "<string>",
    "description": "<string>",
    "external_account_id": "<string>",
    "from_address": "<string>",
    "imad": "<string>",
    "omad": "<string>"
  },
  "status": "awaiting_funds",
  "updated_at": "2023-11-07T05:31:56Z",
  "authorities": [
    "<string>"
  ],
  "completed_at": "2023-11-07T05:31:56Z",
  "error_message": "<string>",
  "fee": "<unknown>",
  "intent_payload": "<string>",
  "memo": "<string>",
  "mpc_payload": "<string>",
  "source_deposit_instructions": "<unknown>",
  "threshold": 123,
  "valid_until": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

API Key for authentication

Headers

​
X-Grid-Environment
string
required

The environment you’re using. Can be sandbox or production.

Path Parameters

​
smart_account_address
string
required

The address of the smart account to create payment intent for

Query Parameters

​
use-mpc-provider
boolean

Whether to use MPC provider for signing

Body

application/json
​
amount
string
required

Amount in the smallest currency unit (e.g., cents for USD)

​
destination
object
required

Destination account details for the payment

  • Option 1
  • Option 2
  • Option 3
  • Option 4
​
grid_user_id
string<uuid>
required

Grid user ID associated with the payment intent

​
source
object
required

Source account details for the payment

  • Option 1
  • Option 2
  • Option 3
  • Option 4
​
webhook_url
string | null

Optional webhook URL for payment status updates

Response

Successfully created payment intent

​
amount
string
required

Amount in the smallest currency unit

​
created_at
string<date-time>
required

UTC timestamp when the payment intent was created

​
currency
enum<string>
required

Currency for the transfer

Available options:
usd,
eur,
mxn,
usdc,
usdt,
usdb,
dai,
pyusd,
eurc
​
destination
object
required

Destination account details

​
id
string
required

Unique identifier for the payment intent

​
payment_rail
enum<string>
required

Payment rail used for the transfer

Available options:
ach,
ach_push,
ach_same_day,
sepa,
swift,
wire,
arbitrum,
avalanche_c_chain,
base,
bridge_wallet,
ethereum,
optimism,
polygon,
solana,
stellar,
tron
​
source
object
required

Source account details

​
status
enum<string>
required

Current status of the payment intent

Available options:
awaiting_funds,
in_review,
funds_received,
payment_submitted,
payment_processed,
canceled,
error,
undeliverable,
returned,
refunded
​
updated_at
string<date-time>
required

UTC timestamp when the payment intent was last updated

​
authorities
string[] | null

Optional list of authorities that can sign the transaction

​
completed_at
string<date-time> | null

UTC timestamp when the payment intent was completed

​
error_message
string | null

Optional error message if the payment intent failed

​
fee
object

Optional fee information

​
intent_payload
string | null

Optional transaction payload for on-chain transfers

​
memo
string | null

Optional memo for the transfer

​
mpc_payload
string | null

Optional MPC provider payload for signing

​
source_deposit_instructions
object

Optional deposit instructions for the source account

​
threshold
integer<int32> | null

Optional threshold of required signatures

​
valid_until
string<date-time> | null

Optional expiration timestamp for the payment intent