{"uid":"cap_AuPpn-Lzx55ITb05Ny2Ul","slug":"brij-air-refund-requests-4aa5dc61","name":"Brij Air Refund Requests","description":"The intent id travels in the request body; the resource URL is static. Paid x402 endpoint. Send a valid `PAYMENT-SIGNATURE` header to record\nthe refund request. Without payment, the API returns `402 Payment Required`.\n\nRecords a refund request for a booked intent. The on-chain escrow has\nalready been captured by the time the intent is `booked`, so refunds at\nthis stage are processed manually by an operator. This endpoint persists\nthe request and pages the operator on Telegram; the response is\n`202 Accepted` and is **not** a guarantee of refund — eligibility and\nany applicable carrier penalties are reviewed manually.\n\nFor pre-capture states (`active`), the booking_sync worker handles\nrefunds automatically; this endpoint returns `409 use_automatic_refund`\nfor those.\n\nThe caller must include the `X-Customer-Support-Code` header matching\nthe code returned at intent creation.\n\n\nFor multi-passenger bookings, X-Passenger-Family-Name is the LEAD passenger's family name (position 0 of the /air/book list).","url":"https://travel.brij.fi/air/refund-requests?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["intent_id","reason"],"properties":{"reason":{"type":"string","maxLength":1000,"description":"Free-text explanation of why the refund is requested."},"contact":{"type":"string","maxLength":320,"description":"Optional reply-to channel (email, phone, etc.) the operator can use to follow up."},"intent_id":{"type":"string","example":"intent_0000000000000000","description":"Id returned by POST /air/intents."}}},"responseSchema":{"type":"object","required":["intent_id","requested_at","status"],"properties":{"status":{"enum":["received"],"type":"string"},"intent_id":{"type":"string"},"requested_at":{"type":"string","format":"date-time"}}},"example":null,"exampleRequest":null,"tags":["x402","shopping"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_upfPFSvyWm-A3hOjQIjk_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Records a manual refund request for a booked (post-capture) flight intent and pages an operator on Telegram for review.","exampleAgentPrompt":"I need to request a refund for my booked flight — the intent ID is intent_0000000000000001 — because my travel plans were cancelled due to a medical emergency. My contact email is john@example.com and my customer support code is SUP-1234.","exampleUseCases":[{"title":"Post-capture flight cancellation request","prompt":"I need to cancel my booked flight and get a refund. The booking intent ID is intent_0000000000000042, my reason is that the conference I was attending got cancelled, and you can reach me at jane@example.com. My customer support code is CS-9987."},{"title":"Medical emergency refund escalation","prompt":"I had a medical emergency and can't travel anymore — please submit a refund request for intent intent_0000000000000099. The reason is hospitalization and my contact number is +1-555-234-5678. My support code is CS-4412."},{"title":"Multi-passenger booking refund for lead passenger","prompt":"Our whole family needs to cancel our trip. Submit a refund request for intent intent_0000000000000077 — reason is a visa denial — and contact us at family@example.com. Our support code is CS-3301 and the lead passenger's last name is Garcia."}],"resultDescription":"Returns HTTP 202 Accepted with a JSON object containing the intent_id, a requested_at ISO 8601 timestamp, and a status of 'received'. This confirms the request was logged and the operator was paged on Telegram, but does NOT guarantee a refund — eligibility and carrier penalties are reviewed manually.","failureModes":["402 Payment Required — missing or invalid PAYMENT-SIGNATURE header; caller must pay $0.10 USDC via x402","409 use_automatic_refund — intent is still in pre-capture 'active' state; use the booking_sync worker instead","401/403 — X-Customer-Support-Code header missing or does not match the code issued at intent creation","400 Bad Request — intent_id or reason field missing or malformed","404 Not Found — intent_id does not exist or belongs to a different account"],"whenToPreferThis":"Use this endpoint when a flight booking intent has already been captured on-chain (status: booked) and the traveler needs to request a refund manually. For pre-capture (active) intents, the automatic booking_sync worker handles refunds and this endpoint will return 409. Choose this over any generic support form when you need the refund request to be persisted in the Brij system and the operator to be alerted immediately via Telegram.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:32:22.128Z","isFirstParty":false,"canonicalSlug":"brij-air-refund-requests-4aa5dc61"}