---
title: "Check payment status"
method: GET
path: "/api/v2/agent/payment-status/{intentId}"
tags: ["Payments"]
---

# Check payment status

`GET /api/v2/agent/payment-status/{intentId}`

## Request

- Base URL: `https://powersun.vip`
- URL: `https://powersun.vip/api/v2/agent/payment-status/{intentId}`
- Auth: none required

Poll status of a 402 payment intent. No authentication required.

## Path parameters

- `intentId` string, required

## Response `200`

Payment intent status

- object
  - `intentId` string
  - `status` 'pending' | 'received' | 'processing' | 'completed' | 'expired' | 'failed'
  - `requiredAmountTrx` number
  - `message` string
  - `scheme` 'tron-transfer' | 'exact'
  - `paymentStage` string: x402 journal phase; unknown means confirmation is pending, not a failed payment
  - `requiredAmountUsdc` string
  - `receivedAmountUsdc` string
  - `settlementTransaction` string
  - `order` Order
    - `orderId` string, uuid
    - `status` 'pending' | 'active' | 'processing' | 'completed' | 'failed' | 'cancelled' | 'expired'
    - `resourceType` 'ENERGY' | 'BANDWIDTH'
    - `energyDelegated` integer
    - `targetAddress` string
    - `durationMinutes` integer
    - `totalCostTrx` number
    - `createdAt` string, date-time

---

[API](https://skmtc.dev/powersun/apis/powersun-agent-api.md) · [All operations](https://skmtc.dev/powersun/apis/powersun-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/powersun/apis/powersun-agent-api/revisions/169cc1ebfd26?raw)