Resolve Admin Task X402 Payment

Support resolution of a WEDGED PENDING x402 payment: flips it to REFUNDED, mints the compensating refund, and writes an operator audit row. PENDING only. Resolution is refused while either the sign lease is active or signRiskExpiresAt says a discarded authorization may still be live; the 409 identifies when to retry. VERIFIED is refused because its header may still settle, and only the goodwill refund may reverse it. Idempotent; FAILED/REFUNDED are already compensated (409). Requires an interactive admin session.

Authorization

bearerAuth

AuthorizationBearer <token>

Authentication required for all endpoints. Supports Better Auth user credentials, dedicated coworker bearer API keys (coworker_), and the orchestrator service bearer (ORCHESTRATOR_SERVICE_TOKEN).

In: header

Path Parameters

id*string

Task x402 payment ID

Lengthlength <= 128

Request Body

application/json

reason*string

Coded resolution rationale. Narrative text and personal data are not accepted because the audit row survives account deletion.

Value in"account_deletion_blocked" | "node_unreachable" | "sign_attempts_exhausted" | "unsettleable_authorization"

Response Body

`application/json`

curl -X POST "https://loading/v1/admin/task-x402-payments/0198b2f4-1111-7000-8000-000000000000/resolve" \  -H "Content-Type: application/json" \  -d '{    "reason": "sign_attempts_exhausted"  }'

{
  "data": {
    "status": "resolved",
    "paymentId": "string",
    "reason": "string",
    "compensated": true
  },
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "pagination": {
      "cursor": "cmg4zknxt0000l404yn4li0kp",
      "limit": 20,
      "total": 100,
      "nextCursor": "cmi4gmksz000104l8wps8p7fp"
    }
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "already_resolved",
  "retryAfter": "2026-08-12T10:00:30.000Z",
  "retryAfterSeconds": 25,
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

Resolve Admin Task X402 Payment

Authorization

Path Parameters

Request Body

Response Body

200application/json

401application/json

403application/json

404application/json

409application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`