payloadexchange-operator

Original：🇺🇸 English

Translated

Operate sponsored APIs and x402-style campaigns for PayloadExchange, including profile onboarding, sponsor campaign setup, task gating, sponsored API creation, proxy-paid usage, and creator telemetry logging.

1installs

Sourcecruujon/subsidypayment

Added on2026-04-02

NPX Install

npx skill4agent add cruujon/subsidypayment payloadexchange-operator

SKILL.md Content

View Translation Comparison →

PayloadExchange Operator

Workflow

Start the Rust API service.
If using sponsored APIs, ensure Postgres is configured (
```
DATABASE_URL
```
) and migrations are applied.
Create user profiles with role/tool attributes.
Create sponsor campaigns with target roles, target tools, task gate, and budget.
Record sponsor task completion before allowing proxy-sponsored usage.
Create sponsored APIs via
```
POST /sponsored-apis
```
.

If

SPONSORED_API_CREATE_PRICE_CENTS

> 0, first call

POST /sponsored-apis

without payment, read

PAYMENT-REQUIRED

, then retry with

PAYMENT-SIGNATURE

per x402.

Call sponsored APIs via
```
POST /sponsored-apis/:api_id/run
```
. Calls are free while
```
budget_remaining_cents
```
covers the per-call price; once exhausted, server returns
```
402
```
with
```
PAYMENT-REQUIRED
```
, then retry with
```
PAYMENT-SIGNATURE
```
.
Use
```
/proxy/:service/run
```
for sponsored campaign flows and
```
/tool/:service/run
```
for direct paid flows.
Log skill usage outcomes to
```
/creator/metrics/event
```
.
Read
```
/campaigns/discovery
```
for agent campaign URL sources.
Read
```
/creator/metrics
```
and
```
/metrics
```
for operational monitoring.

Metric Event Contract

Send one telemetry event per key skill action:

```
event_type=created
```
when skill definition is created
```
event_type=installed
```
when copied into Codex/other environment
```
event_type=invoked
```
when skill starts handling a request
```
event_type=completed
```
when task succeeds
```
event_type=failed
```
when task fails

Required fields:

skill_name

,

platform

,

event_type

,

success

. Optional field:

duration_ms

.

x402 Settlement Sync

Use

/webhooks/x402scan/settlement

to ingest external settlement updates and keep sponsored/direct ledger state consistent with the payment rail monitor.