POST
/
smart-accounts
/
{smart_account_address}
/
payment-intents
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": null,
      "account_number": "<string>",
      "account_owner_name": "<string>",
      "account_owner_type": null,
      "account_type": null,
      "address": {
        "city": "<string>",
        "country": "<string>",
        "postal_code": "<string>",
        "state": "<string>",
        "street_line_1": "<string>",
        "street_line_2": "<string>"
      },
      "bank_name": "<string>",
      "business_name": "<string>",
      "currency": null,
      "first_name": "<string>",
      "iban": null,
      "idempotency_key": "<string>",
      "last_name": "<string>",
      "routing_number": "<string>",
      "swift": null
    },
    "payment_rail": "ach"
  },
  "grid_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source": {
    "currency": "usd",
    "details": {
      "account": null,
      "account_number": "<string>",
      "account_owner_name": "<string>",
      "account_owner_type": null,
      "account_type": null,
      "address": {
        "city": "<string>",
        "country": "<string>",
        "postal_code": "<string>",
        "state": "<string>",
        "street_line_1": "<string>",
        "street_line_2": "<string>"
      },
      "bank_name": "<string>",
      "business_name": "<string>",
      "currency": null,
      "first_name": "<string>",
      "iban": null,
      "idempotency_key": "<string>",
      "last_name": "<string>",
      "routing_number": "<string>",
      "swift": null
    },
    "payment_rail": "ach"
  },
  "webhook_url": "<string>"
}'
{
  "amount": "<string>",
  "authorities": [
    "<string>"
  ],
  "completed_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "currency": "usd",
  "destination": {
    "ach_reference": "<string>",
    "blockchain_memo": "<string>",
    "bridge_wallet_id": "<string>",
    "currency": "usd",
    "external_account_id": "<string>",
    "from_address": "<string>",
    "imad": "<string>",
    "omad": "<string>",
    "payment_rail": "ach",
    "sepa_reference": "<string>",
    "swift_charges": "<string>",
    "swift_reference": "<string>",
    "to_address": "<string>",
    "trace_number": "<string>",
    "uetr": "<string>",
    "wire_message": "<string>"
  },
  "error_message": "<string>",
  "fee": null,
  "id": "<string>",
  "intent_payload": "<string>",
  "memo": "<string>",
  "mpc_payload": "<string>",
  "payment_rail": "ach",
  "source": {
    "bank_beneficiary_address": "<string>",
    "bank_beneficiary_name": "<string>",
    "bank_name": "<string>",
    "bank_routing_number": "<string>",
    "bridge_wallet_id": "<string>",
    "currency": "usd",
    "description": "<string>",
    "external_account_id": "<string>",
    "from_address": "<string>",
    "imad": "<string>",
    "omad": "<string>",
    "payment_rail": "ach"
  },
  "source_deposit_instructions": null,
  "status": "awaiting_funds",
  "threshold": 123,
  "updated_at": "2023-11-07T05:31:56Z",
  "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

Response

200
application/json

Successfully created payment intent

The response is of type object.