Refund Admin Task X402 Payment
Goodwill / support-driven refund of a VERIFIED x402 payment (the paid-but-bad-result case, PR1-SPEC §5): flips it to REFUNDED, mints the compensating refund, and writes an operator audit row. Idempotent; only valid on a VERIFIED record — FAILED/REFUNDED are already compensated (409) and PENDING is left for coworker replay or operator resolution (409). Requires an interactive admin session.
Authorization
bearerAuth 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
Task x402 payment ID
length <= 128Request Body
application/json
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://loading/v1/admin/task-x402-payments/0198b2f4-1111-7000-8000-000000000000/refund" \ -H "Content-Type: application/json" \ -d '{ "reason": "agent_output_quality" }'{
"data": {
"status": "refunded",
"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_refunded",
"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"
}
}Refund Admin Task Payment Claim POST
Refund a reviewed task payment claim without parsing its stored purchase payload or contacting the payment node. Use only after confirming out of band that no live purchase exists (admin only).
Remove Admin Organization Member DELETE
Remove a member from an organization (admin only).
