Payments

Grid enables secure and controlled payments through an intent-based architecture. All outgoing payments require explicit authorization from the smart account’s authorities.

Payment Flow

Payment Types

Grid supports various types of payments:

Outgoing Transfers

  • To external bank accounts
  • To other smart accounts
  • To blockchain addresses

Supported Payment Rails

For a comprehensive list of supported payment rails and currencies, see Supported Currencies and Rails.

Supported Currencies

For a complete list of supported currencies, see Supported Currencies and Rails.

Payment Intents

Payment intents represent a desired payment operation that requires authorization. Each intent includes:

  • Amount and currency
  • Source and destination
  • Payment rail
  • Optional memo
  • Webhook URL for notifications

Authorization Requirements

Payment intents require authorization based on the smart account’s policies:

  1. Initiation: Authorities with CAN_INITIATE permission
  2. Approval: Authorities with CAN_VOTE permission
  3. Execution: Authorities with CAN_EXECUTE permission

Monitoring Payments

You can monitor payment status through:

GET /smart-accounts/{address}/payment-intents

Filter by:

  • Payment rail
  • Status
  • Currency
  • Date range
  • Transaction hash

API Reference

For detailed API specifications, see: