# Blackbird API – Refund Payment Intent

> Blackbird API – Refund Payment Intent is a paid API for AI agents from the-stables-blackbird-api.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-16).

Reverses a paid Blackbird Payment Intent by performing a full FLY transfer refund (partial refunds not supported).

## Facts

- Endpoint: POST https://the-stables-blackbird-api.vercel.app/api/payment_intents/:id/refund
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blackbird-api-refund-payment-intent-47f86ab5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zzTTqtO8nKyMptLadHsGt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blackbird-api-refund-payment-intent-47f86ab5 -d '<json body>'
```

Example prompt: Please refund the Blackbird payment intent with ID pi_abc123 — it was already paid and I need to fully reverse the FLY transfer.

## When to prefer this

Use this endpoint when you need to fully reverse a paid Blackbird Payment Intent and return funds via FLY transfer. Choose this over the cancel endpoint (which only works on pending intents) when the payment has already been completed. Note that partial refunds are not supported — use only when a complete reversal is required.

## Known failure modes

- Payment intent not found (invalid or unknown ID) — 404 error
- Payment intent is not in a paid state (already cancelled or refunded) — 400 error
- Missing or invalid Blackbird identity (no wallet linked, invalid JWT, or missing x402/SIWX headers) — 401/403 error
- Partial refund attempted — not supported, endpoint only processes full refunds
- Underlying FLY transfer reversal failure — upstream payment network error

## How this service works

Refund a paid Payment Intent — reverses the full FLY transfer (partial refunds unsupported). Requires a Blackbird identity: link your agent wallet once at /connect, then call with x402 + SIWX (first call pays, later SIWX-signed calls are free); or pass a member JWT in the X-Blackbird-Token header.

## Output

Returns a confirmation that the Payment Intent has been refunded, with the updated intent status reflecting the full FLY transfer reversal. Partial refunds are not supported; the entire amount is reversed.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackbird-api-refund-payment-intent-47f86ab5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stables-blackbird-api.vercel.app](https://www.zero.xyz/host/the-stables-blackbird-api.vercel.app/llms.txt)