{"uid":"cap_zzTTqtO8nKyMptLadHsGt","slug":"blackbird-api-refund-payment-intent-47f86ab5","name":"Blackbird API – Refund Payment Intent","description":"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.","url":"https://the-stables-blackbird-api.vercel.app/api/payment_intents/:id/refund","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5D0qfm9hbsg1lS2YfVqgw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reverses a paid Blackbird Payment Intent by performing a full FLY transfer refund (partial refunds not supported).","exampleAgentPrompt":"Please refund the Blackbird payment intent with ID pi_abc123 — it was already paid and I need to fully reverse the FLY transfer.","exampleUseCases":[{"title":"Reverse accidental restaurant charge","prompt":"A guest was charged twice for their Blackbird dining session — please refund the duplicate payment intent pi_xyz789 and reverse the FLY transfer."},{"title":"Refund cancelled reservation payment","prompt":"The reservation was cancelled after payment went through — issue a full refund on Blackbird payment intent pi_res456 so the member gets their money back."},{"title":"Agent-initiated post-event refund","prompt":"Our event ended early and we need to refund the attendee's Blackbird payment intent pi_event321 — do a full FLY transfer reversal for them."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:08.411Z","isFirstParty":false}