Skip to main content
POST
Create a payment intent (v2)

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:
fees
null | 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
null | object

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

destination_amount
null | object

Destination amount breakdown when returned by provider.

next_action
null | 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
null | object

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