{"uid":"cap_5YtYZhsEDc-JsmfX-bW1s","slug":"blackbird-api-cancel-payment-intent-2e55f568","name":"Blackbird API – Cancel Payment Intent","description":"Cancel a pending Payment Intent. Idempotent; 400 if already paid or refunded. 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/cancel","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_pJWKqMdGhI_HeAoyN0gHg","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":"Cancels a pending (unpaid) Blackbird Payment Intent by ID, preventing it from being charged.","exampleAgentPrompt":"Cancel the pending Blackbird payment intent with ID pi_abc123 — it hasn't been paid yet and I want to make sure it won't go through.","exampleUseCases":[{"title":"Abort accidental payment intent","prompt":"I accidentally created a Blackbird payment intent with ID pi_xyz789 — it hasn't been paid yet, can you cancel it before anyone charges it?"},{"title":"Void payment after order cancellation","prompt":"The customer just cancelled their order, so please cancel the pending Blackbird payment intent pi_def456 so no charge goes through."},{"title":"Clean up stale unpaid intents","prompt":"I have a Blackbird payment intent pi_ghi012 that's been sitting unpaid for too long — go ahead and cancel it."}],"resultDescription":"Returns a confirmation that the payment intent has been cancelled, including its updated status. Returns a 400 error if the intent has already been paid or refunded, since cancellation is only valid for pending (uncharged) intents. The operation is idempotent — cancelling an already-cancelled intent succeeds without error.","failureModes":["400 Bad Request if payment intent has already been paid","400 Bad Request if payment intent has already been refunded","404 Not Found if the payment intent ID does not exist","401 Unauthorized if no valid Blackbird identity (wallet via x402/SIWX or member JWT) is provided","403 Forbidden if the authenticated identity does not own the payment intent"],"whenToPreferThis":"Use this endpoint when you need to void a Blackbird payment intent that is still in a pending (unpaid) state — for example after an order cancellation, an accidental creation, or a session timeout. This is the correct endpoint when the intent has NOT yet been paid; for reversing a completed payment, use the refund endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:33:02.010Z","isFirstParty":false}