{"uid":"cap_8TzGIakGnl5RdmCcWqgff","slug":"blackbird-api-retrieve-payment-intent-7b5c935f","name":"Blackbird API – Retrieve Payment Intent","description":"Retrieve a Payment Intent with its derived status. 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","method":"GET","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_HisILpJ_CefjoSCuFgN5R","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":"Fetch a single Payment Intent by ID and return its current derived status (e.g. pending, paid, cancelled, refunded).","exampleAgentPrompt":"Can you look up Blackbird payment intent pmt_abc123xyz and tell me what its current status is — whether it's still pending, been paid, or something else?","exampleUseCases":[{"title":"Verify a dine payment completed","prompt":"Check Blackbird payment intent pmt_9f83kd2 for me — I need to confirm whether the payment actually went through or is still pending."},{"title":"Audit a refunded transaction","prompt":"Pull up Blackbird payment intent pmt_zx72mq9 and tell me its derived status — I'm trying to confirm the refund was processed correctly."},{"title":"Agent reconciles loyalty payment","prompt":"Fetch the details for Blackbird payment intent pmt_17bvcp4 so I can see its status and the FLY transfer info tied to it."}],"resultDescription":"Returns a Payment Intent object including its unique ID, derived status (pending, paid, cancelled, or refunded), associated amount, FLY transfer details, and timestamps. The derived status reflects the most current computed state of the payment lifecycle.","failureModes":["404 if the payment intent ID does not exist or belongs to another member","401 if no valid Blackbird identity is provided (missing x402 credential or member JWT)","400 if the request is malformed","Payment required (402) on first call without a pre-linked wallet, triggering x402 flow","Rate limiting or quota errors if called excessively"],"whenToPreferThis":"Use this endpoint when you need to check or confirm the current status of a specific Blackbird payment intent by ID — for example, to verify a transaction completed, confirm a refund was applied, or audit a payment record. Prefer it over list-style endpoints when you already have the payment intent ID and need authoritative status for a single record.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:01.457Z","isFirstParty":false}