Skip to main content
POST
/
api
/
grid
/
v2
/
accounts
/
{address}
/
payment-intents
Create a payment intent (v2)
curl --request POST \
  --url https://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-grid-environment: <x-grid-environment>' \
  --data '
{
  "amount": "100000000",
  "destination": {
    "currency": "USD",
    "external_account_id": "6f4f23d5-5ca8-4c62-92f8-9d730f89adf4",
    "payment_rail": "SWIFT",
    "reference": "Invoice #2026-001"
  },
  "source": {
    "currency": "USDC",
    "payment_rail": "SOLANA",
    "account_id": "ewa_abc123"
  },
  "client_reference_id": "invoice-2026-001",
  "document_ids": [
    "doc_abc123"
  ],
  "fees": {
    "developer_fee_fixed": 10000,
    "developer_fee_percent": 0.015
  },
  "memo": "Invoice #2026-001",
  "mode": "destination_address",
  "payment_reason": "PAYMENT_FOR_GOODS_AND_SERVICES",
  "remarks": "Payable for March settlement"
}
'
{
  "created_at": "2026-03-05T08:14:01Z",
  "destination": {
    "currency": "USDC",
    "payment_rail": "SOLANA",
    "account_id": "ewa_abc123",
    "address": "8B57MCi1FX7ydB5SJUbWT5FWUwoHT88JsEfSFwNx32CV",
    "external_account_id": "eba_abc123"
  },
  "id": "pi_tfr_9w7d3m2a",
  "mode": "destination_address",
  "object": "payment_intent",
  "provider": "infinite",
  "source": {
    "currency": "USDC",
    "payment_rail": "SOLANA",
    "account_id": "ewa_abc123",
    "address": "8B57MCi1FX7ydB5SJUbWT5FWUwoHT88JsEfSFwNx32CV",
    "external_account_id": "eba_abc123"
  },
  "source_amount": {
    "currency": "USDC",
    "display_value": "1.000000",
    "exponent": 6,
    "value": "1000000"
  },
  "status": "pending",
  "updated_at": "2026-03-05T08:14:01Z",
  "deposit": {
    "amount": {
      "currency": "USDC",
      "display_value": "1.000000",
      "exponent": 6,
      "value": "1000000"
    },
    "deposit_type": "fiat",
    "payment_rail": "SWIFT",
    "account_id": "eba_abc123",
    "account_number": "1234567890",
    "bank_address_line": "270 PARK AVENUE, NEW YORK, NY",
    "bank_name": "JPMORGAN CHASE BANK",
    "beneficiary_name": "Acme Corp",
    "clabe": "002010077777777771",
    "iban": "GB33BUKB20201555555555",
    "memo": "Payment reference",
    "reference": "Invoice #2026-001",
    "routing_number": "021000021",
    "swift_bic": "CHASUS33",
    "to_address": "8B57MCi1FX7ydB5SJUbWT5FWUwoHT88JsEfSFwNx32CV"
  },
  "destination_amount": {
    "currency": "USDC",
    "display_value": "1.000000",
    "exponent": 6,
    "value": "1000000"
  },
  "next_action": {
    "action_type": "await_funding"
  },
  "provider_fields": {},
  "sign_prebuilt_tx": {
    "encoding": "base64",
    "transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAED..."
  }
}

Authorizations

​
Authorization
string
header
required

Your Grid API key from the Grid Dashboard

Headers

​
x-grid-environment
string
required

Environment (sandbox, production)

​
x-idempotency-key
string | null

Idempotency key forwarded to the provider (auto-generated when omitted)

Path Parameters

​
address
string
required

Smart account address

Body

application/json
​
amount
string
required

Integer amount in source currency smallest units (for example, 1 USDC = 1000000 when exponent is 6).

Example:

"100000000"

​
destination
object
required

Destination leg details.

​
source
object
required

Source leg details.

​
client_reference_id
string | null

Optional caller-defined reference for reconciliation.

Example:

"invoice-2026-001"

​
document_ids
string[] | null

Optional provider document identifiers (for example, for third-party payouts requiring supporting docs).

Example:
["doc_abc123"]
​
fees
object

Optional fee controls; forwarded to providers that support fee fields.

​
memo
string | null

Free-form memo/reference.

Example:

"Invoice #2026-001"

​
mode
enum<string>

Intent mode. Defaults to destination_address.

Available options:
destination_address
​
payment_reason
string | null

Provider payment reason enum string. Forwarded when supported.

Example:

"PAYMENT_FOR_GOODS_AND_SERVICES"

​
remarks
string | null

Provider remarks forwarded to providers that support a dedicated remarks field.

Example:

"Payable for March settlement"

Response

Payment intent created

​
created_at
string
required

RFC3339 creation timestamp.

Example:

"2026-03-05T08:14:01Z"

​
destination
object
required

Normalized destination party details.

​
id
string
required

Payment intent identifier.

Example:

"pi_tfr_9w7d3m2a"

​
mode
enum<string>
required

Requested intent mode.

Available options:
destination_address
​
object
string
required

Resource type.

Example:

"payment_intent"

​
provider
string
required

Provider that executed the request.

Example:

"infinite"

​
source
object
required

Normalized source party details.

​
source_amount
object
required

Source amount breakdown.

​
status
string
required

Provider-backed payment intent status.

Example:

"pending"

​
updated_at
string
required

RFC3339 update timestamp.

Example:

"2026-03-05T08:14:01Z"

​
deposit
object

Flat deposit action. Present when caller needs to transfer funds using returned instructions.

​
destination_amount
object

Destination amount breakdown when returned by provider.

​
next_action
object

Optional hint for additional follow-up action in future multi-step flows.

​
provider_fields
object

Provider-specific raw attributes for advanced integrations.

​
sign_prebuilt_tx
object

Flat signing action. Present when caller must sign and broadcast a prepared transaction.