Payment Intent API

Paygrid

Website

Initiate a new payment intent

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

post

/payments

Authorizations

Body

amountinteger · min: 1required

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

processing_dateinteger · unix-timestamp

Future processing timestamp, required for scheduled payments

expiration_dateinteger · unix-timestamp

Signature expiration timestamp, must match permit2 deadline

payment_referencestring

External reference for payment reconciliation and tracking

metadataobject

Generic JSON key-value metadata about the payment workflow

payment_typestring · enum · default: one-time

The payment intent type

Options: one-time, recurring

routing_prioritystring · enum · default: AUTO

Routing strategy for cross-chain payments

Options: COST, SPEED, BALANCED, AUTO

scheduleobject

The payment schedule for recurring payments

processing_feesobject

operator_dataobjectrequired

sourceobjectrequired

destinationobjectrequired

authorizationsobjectrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api-core.paygrid.co/v1/payments' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"amount":1,"metadata":{"ANY_ADDITIONAL_PROPERTY":"anything"},"payment_type":"one-time","routing_priority":"AUTO","schedule":{"interval_count":1,"start_date":1,"interval_unit":"DAY"},"processing_fees":{"corridor_fees":"text","charge_bearer":"OPERATOR"},"operator_data":{"id":"text","operator":"text","treasury":"text","fee_bps":0,"authorized_delegates":[null]},"source":{"from_account":"text","payment_token":"text","network_id":"ETHEREUM"},"destination":{"to_account":"text","payment_token":"text","network_id":"ETHEREUM"},"authorizations":{"permit2_permit":{"signature":"text","nonce":"text","deadline":1},"initial_permit":{}}}'

201

400

401

500

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-02-23T16:39:54.726Z",
  "updatedAt": "2025-02-23T16:39:54.726Z",
  "operator_data": {
    "id": "text",
    "operator": "text",
    "treasury": "text",
    "fee_bps": 0,
    "webhook_url": "https://example.com",
    "authorized_delegates": [
      "text"
    ]
  },
  "amount": 1,
  "source": {
    "from_account": "text",
    "payment_token": "text",
    "network_id": "ETHEREUM"
  },
  "destination": {
    "to_account": "text",
    "payment_token": "text",
    "network_id": "ETHEREUM"
  },
  "schedule": {
    "interval_count": 1,
    "iterations": 1,
    "start_date": 1,
    "end_date": 1,
    "completed_iterations": 1,
    "next_execution_date": 1,
    "interval_unit": "DAY"
  },
  "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"
  },
  "status": "PROCESSING",
  "payment_type": "one-time",
  "routing_priority": "AUTO",
  "blockchain_metadata": {
    "payment_gateway_proxy": "text",
    "transaction": {
      "src_transaction_hash": "text",
      "dst_transaction_hash": "text",
      "tracking_link": "https://example.com"
    }
  }
}

Payment intent created successfully

List all payment intents

Retrieves a paginated list of payment intents

get

/payments

Authorizations

Query parameters

pageinteger · min: 1 · default: 1

Page number (starts from 1)

limitinteger · min: 1 · max: 100 · default: 10

Items per page (max 100)

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api-core.paygrid.co/v1/payments' \
  --header 'X-API-KEY: YOUR_API_KEY'

200

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-02-23T16:39:54.726Z",
      "updatedAt": "2025-02-23T16:39:54.726Z",
      "operator_data": {
        "id": "text",
        "operator": "text",
        "treasury": "text",
        "fee_bps": 0,
        "webhook_url": "https://example.com",
        "authorized_delegates": [
          "text"
        ]
      },
      "amount": 1,
      "source": {
        "from_account": "text",
        "payment_token": "text",
        "network_id": "ETHEREUM"
      },
      "destination": {
        "to_account": "text",
        "payment_token": "text",
        "network_id": "ETHEREUM"
      },
      "schedule": {
        "interval_count": 1,
        "iterations": 1,
        "start_date": 1,
        "end_date": 1,
        "completed_iterations": 1,
        "next_execution_date": 1,
        "interval_unit": "DAY"
      },
      "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"
      },
      "status": "PROCESSING",
      "payment_type": "one-time",
      "routing_priority": "AUTO",
      "blockchain_metadata": {
        "payment_gateway_proxy": "text",
        "transaction": {
          "src_transaction_hash": "text",
          "dst_transaction_hash": "text",
          "tracking_link": "https://example.com"
        }
      }
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "pages": 1
  }
}

List of payment intents

Get payment intent details

Retrieves detailed information about a specific payment intent

get

/payments/{payment_id}

Authorizations

Path parameters

payment_idstring · uuidrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api-core.paygrid.co/v1/payments/{payment_id}' \
  --header 'X-API-KEY: YOUR_API_KEY'

200

404

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-02-23T16:39:54.726Z",
  "updatedAt": "2025-02-23T16:39:54.726Z",
  "operator_data": {
    "id": "text",
    "operator": "text",
    "treasury": "text",
    "fee_bps": 0,
    "webhook_url": "https://example.com",
    "authorized_delegates": [
      "text"
    ]
  },
  "amount": 1,
  "source": {
    "from_account": "text",
    "payment_token": "text",
    "network_id": "ETHEREUM"
  },
  "destination": {
    "to_account": "text",
    "payment_token": "text",
    "network_id": "ETHEREUM"
  },
  "schedule": {
    "interval_count": 1,
    "iterations": 1,
    "start_date": 1,
    "end_date": 1,
    "completed_iterations": 1,
    "next_execution_date": 1,
    "interval_unit": "DAY"
  },
  "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"
  },
  "status": "PROCESSING",
  "payment_type": "one-time",
  "routing_priority": "AUTO",
  "blockchain_metadata": {
    "payment_gateway_proxy": "text",
    "transaction": {
      "src_transaction_hash": "text",
      "dst_transaction_hash": "text",
      "tracking_link": "https://example.com"
    }
  }
}

Payment intent details