Paygrid
WebsiteDiscord
  • Getting started
    • Introduction
    • Reach out
  • How it works
    • Demo
    • Core features
      • Chain abstracted payments
      • Payment Clearing and MEV
    • Supported Networks & Tokens
  • Use cases
    • Payment workflows
    • Recurring workflows
    • Invoice workflows
    • Agentic workflows
    • DeFi - High Frequency Trading workflows
  • Technical Docs
    • What is a Payment Intent?
    • What is a Corridor?
    • Payment Lifecycle
    • Paygrid API
      • Authentication
      • Payment Intent API
      • Corridor Pricing API
      • Webhooks & IPN Events
      • Payment Recovery & Fallback Guarantees
    • Paygrid SDK
      • Quickstart
    • Security Considerations
  • Resources
    • Discord
    • Brand assets
Powered by GitBook
On this page
  1. Technical Docs
  2. Paygrid API

Payment Intent API

PreviousAuthenticationNextCorridor Pricing API

Last updated 4 months ago

Get payment intent details

get

Retrieves detailed information about a specific payment intent

Authorizations
Path parameters
payment_idstring · uuidRequired
Responses
200
Payment intent details
application/json
404
Payment intent not found
application/json
get
GET /v1/payments/{payment_id} HTTP/1.1
Host: api-core.paygrid.co
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "RELEASED_TO_GATEWAY",
  "blockchain_metadata": {
    "payment_gateway_proxy": "text",
    "transaction": {
      "src_transaction_hash": "text",
      "dst_transaction_hash": "text",
      "tracking_link": "https://example.com"
    }
  },
  "createdAt": "2025-05-09T11:26:55.786Z",
  "updatedAt": "2025-05-09T11:26:55.786Z",
  "payment_type": "one-time",
  "routing_priority": "COST",
  "operator_data": {
    "id": "text",
    "operator": "text",
    "authorized_delegates": [
      "text"
    ],
    "treasury": "text",
    "fee_bps": 1,
    "webhook_url": "https://example.com"
  },
  "amount": 1,
  "source": {
    "from_account": "text",
    "network_id": "ETHEREUM",
    "payment_token": "text"
  },
  "destination": {
    "to_account": "text",
    "network_id": "ETHEREUM",
    "payment_token": "text"
  },
  "schedule": {
    "interval_unit": "DAY",
    "interval_count": 1,
    "iterations": 1,
    "start_date": 1,
    "end_date": 1,
    "completed_iterations": 1,
    "next_execution_date": 1
  },
  "processing_date": 1,
  "expiration_date": 1,
  "authorizations": {
    "p2_signature": "text",
    "initial_permit": "text",
    "nonce": "text",
    "deadline": 1
  },
  "processing_fees": {
    "corridor_fees": "10.50",
    "charge_bearer": "OPERATOR"
  },
  "payment_reference": "text",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}
  • POSTInitiate a new payment intent
  • GETList all payment intents
  • GETGet payment intent details

List all payment intents

get

Retrieves a paginated list of payment intents

Authorizations
Query parameters
pageinteger · min: 1Optional

Page number (starts from 1)

Default: 1
limitinteger · min: 1 · max: 100Optional

Items per page (max 100)

Default: 10
Responses
200
List of payment intents
application/json
get
GET /v1/payments HTTP/1.1
Host: api-core.paygrid.co
X-API-KEY: YOUR_API_KEY
Accept: */*
200

List of payment intents

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "status": "RELEASED_TO_GATEWAY",
      "blockchain_metadata": {
        "payment_gateway_proxy": "text",
        "transaction": {
          "src_transaction_hash": "text",
          "dst_transaction_hash": "text",
          "tracking_link": "https://example.com"
        }
      },
      "createdAt": "2025-05-09T11:26:55.786Z",
      "updatedAt": "2025-05-09T11:26:55.786Z",
      "payment_type": "one-time",
      "routing_priority": "COST",
      "operator_data": {
        "id": "text",
        "operator": "text",
        "authorized_delegates": [
          "text"
        ],
        "treasury": "text",
        "fee_bps": 1,
        "webhook_url": "https://example.com"
      },
      "amount": 1,
      "source": {
        "from_account": "text",
        "network_id": "ETHEREUM",
        "payment_token": "text"
      },
      "destination": {
        "to_account": "text",
        "network_id": "ETHEREUM",
        "payment_token": "text"
      },
      "schedule": {
        "interval_unit": "DAY",
        "interval_count": 1,
        "iterations": 1,
        "start_date": 1,
        "end_date": 1,
        "completed_iterations": 1,
        "next_execution_date": 1
      },
      "processing_date": 1,
      "expiration_date": 1,
      "authorizations": {
        "p2_signature": "text",
        "initial_permit": "text",
        "nonce": "text",
        "deadline": 1
      },
      "processing_fees": {
        "corridor_fees": "10.50",
        "charge_bearer": "OPERATOR"
      },
      "payment_reference": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "pages": 1
  }
}

Initiate a new payment intent

post

Initiates a new payment intent for processing one-time or recurring payments across blockchain networks.

Authorizations
Body
payment_typestring · enumOptional

The payment intent type

Default: one-timePossible values:
routing_prioritystring · enumOptional

Routing strategy for cross-chain payments

Default: AUTOPossible values:
amountinteger · min: 1Required

Gross amount to be transferred in cents, before any fees are applied (e.g., $10.00 = 1000)

processing_dateinteger · unix-timestampOptional

Future processing timestamp, required for scheduled payments

expiration_dateinteger · unix-timestampOptional

Signature expiration timestamp, must match permit2 deadline

payment_referencestringOptional

External reference for payment reconciliation and tracking

Responses
201
Payment intent created successfully
application/json
400
Invalid request parameters
application/json
401
Missing or invalid API key
application/json
500
Internal server error occurred. Please include the requestId when contacting Paygrid team.
application/json
post
POST /v1/payments HTTP/1.1
Host: api-core.paygrid.co
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 808

{
  "payment_type": "one-time",
  "routing_priority": "COST",
  "operator_data": {
    "id": "text",
    "operator": "text",
    "authorized_delegates": [
      "text"
    ],
    "treasury": "text",
    "fee_bps": 1,
    "webhook_url": "https://example.com"
  },
  "amount": 1,
  "source": {
    "from_account": "text",
    "network_id": "ETHEREUM",
    "payment_token": "text"
  },
  "destination": {
    "to_account": "text",
    "network_id": "ETHEREUM",
    "payment_token": "text"
  },
  "schedule": {
    "interval_unit": "DAY",
    "interval_count": 1,
    "iterations": 1,
    "start_date": 1,
    "end_date": 1
  },
  "processing_date": 1,
  "expiration_date": 1,
  "authorizations": {
    "permit2_permit": {
      "signature": "text",
      "nonce": "text",
      "deadline": 1
    },
    "initial_permit": {
      "signature": "text",
      "nonce": "text",
      "deadline": 1
    }
  },
  "processing_fees": {
    "corridor_fees": "text",
    "charge_bearer": "OPERATOR"
  },
  "payment_reference": "text",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "RELEASED_TO_GATEWAY",
  "blockchain_metadata": {
    "payment_gateway_proxy": "text",
    "transaction": {
      "src_transaction_hash": "text",
      "dst_transaction_hash": "text",
      "tracking_link": "https://example.com"
    }
  },
  "createdAt": "2025-05-09T11:26:55.786Z",
  "updatedAt": "2025-05-09T11:26:55.786Z",
  "payment_type": "one-time",
  "routing_priority": "COST",
  "operator_data": {
    "id": "text",
    "operator": "text",
    "authorized_delegates": [
      "text"
    ],
    "treasury": "text",
    "fee_bps": 1,
    "webhook_url": "https://example.com"
  },
  "amount": 1,
  "source": {
    "from_account": "text",
    "network_id": "ETHEREUM",
    "payment_token": "text"
  },
  "destination": {
    "to_account": "text",
    "network_id": "ETHEREUM",
    "payment_token": "text"
  },
  "schedule": {
    "interval_unit": "DAY",
    "interval_count": 1,
    "iterations": 1,
    "start_date": 1,
    "end_date": 1,
    "completed_iterations": 1,
    "next_execution_date": 1
  },
  "processing_date": 1,
  "expiration_date": 1,
  "authorizations": {
    "p2_signature": "text",
    "initial_permit": "text",
    "nonce": "text",
    "deadline": 1
  },
  "processing_fees": {
    "corridor_fees": "10.50",
    "charge_bearer": "OPERATOR"
  },
  "payment_reference": "text",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}