Travel Consultant
Xianzong Travel Consultation - travel plans, itineraries, trip guides for family, elderly & group trips, outbound travel. Any brief becomes a real plan: day-by-day schedule, itemized budget, transport/lodging, pacing & fallbacks. Markdown + PDF by email. CNY 0.99/call via Alipay AI pay-per-use
Xianzong Wendao · Travel Consultation
CNY 0.99 (approx USD 0.15) turns a vague travel idea into an itinerary you can follow as written. More than "where to go": how to get there, what it costs, and how to adjust when you are tired / it rains / the tickets sold out — all in the same document. Say "where, how many days, who is coming, what budget", and minutes later you get an executable day-by-day itinerary, an itemized budget with transport and lodging advice, and a typeset PDF with cover and table of contents.
Actually verified, not made up: ticket prices, opening hours, booking rules and schedules are checked online. Confirmed items are labelled verified (value + source + date); everything else stays to be verified with the channel to confirm — nothing uncertain is written as fact, and each verified item is traceable.
What you get
| Deliverable | Details |
|---|---|
| Day-by-day itinerary (Markdown) | Where to go each day, how long to stay, how to connect, what to eat, which area to stay in, roughly how much it costs |
| Typeset PDF plan | Cover (running head + your question + destination / travel dates / delivered-by cards) + table of contents + body + branded footer with the official site; ~90-day download link, also emailed to the address you provide |
| Reference material (optional) | Destination knowledge-base items on attractions, food, transport, lodging, history and culture; returned by default |
One consultation covers one trip (one destination and one time window); consult separately for different trips.
Two real delivery samples
Before paying you can open the two PDFs below. Both are actual deliveries from the same generation and typesetting pipeline as a paid consultation — judge for yourself whether they are ready to use, then decide whether to consult.
| Sample | Scenario | Link |
|---|---|---|
| Beijing · 4 days / 3 nights, autumn-break family trip | Two adults and one 8-year-old, autumn-break trip to Beijing (Great Wall, Universal Studios, Forbidden City central axis) | Travel plan - Beijing (PDF) |
| UK · 9 days, Spring Festival family trip | Two adults and one 8-year-old, Spring Festival trip to the UK (6 nights in London + 1 night in York) | Travel plan - UK (PDF) |
Both samples show, directly: the cover (question / destination / dates / delivered by), the table of contents, time-block-level day plans, the itemized budget table, the pre-trip verification checklist, and the closing "this report was generated by AI..." notice. What is inside the PDF is everything one consultation produces — there are no hidden sections.
The difference in one sentence
It does not just recommend where to go — it works out how to get there, what it costs, and how to adjust when you are tired / it rains / the tickets sold out.
The gap is not "more attractions, longer text" but more complete execution detail: itinerary, budget, rest plan and contingency handling live in the same document, so you do not have to research the rest yourself.
| Strength | What it actually does (verifiable line by line in the samples above) |
|---|---|
| An itinerary you can execute | Daily route + transport connections + lodging area + booking reminders, down to departure times, the reason for each stop's order, and how far ahead to book |
| A budget you can read | Itemized budget table (transport / lodging / tickets / food priced separately) stating head count, nights, child pricing rule and FX basis, plus a "recalculation method" so you can re-price it yourself |
| Family detail | Attraction selection by age and height (anything below the height limit is skipped outright), mandatory rest windows, a cap on continuous walking, and shortened routes for low stamina |
| Contingencies covered | Concrete fallbacks for rain, sold-out tickets, temporary closures, a tired child and transport delays, with a clear mark on what must be verified in advance |
Compared dimension by dimension with a generic AI itinerary
A generic AI can also produce an itinerary, but most stop at the "suggestion layer" (attraction list + rough order + vague days); this service delivers the "execution layer". Every line below can be checked in the sample PDFs:
| Dimension | Where generic AI usually stops | This service (see the two samples above) |
|---|---|---|
| Assumptions and prerequisites | Basic context such as head count, ages and season, plus some selection suggestions | Two dedicated opening sections: "5 things to confirm before you go" + "assumptions of this plan" — holiday start/end, flight branches (two distinct walks for branch A / branch B), FX basis, whether the budget includes long-haul travel, walking ability of the adults; plus what to adjust if an assumption changes |
| Itinerary execution | Time blocks, attractions, visit durations and reminders | Additionally departure times, transport mode and duration, the exact walking route, and rest locations: leave at 07:30 (60-120 min each way; public transport not recommended with a child), change to the shuttle bus at 09:30, walk only towers 14 to 16 between 10:00 and 11:30 |
| Tickets and admission | Reminders about reservations and opening hours | Written as hard constraints: the Forbidden City closes on Mondays, tickets drop 7 days ahead at 20:00, no on-site sales, under-18s are free but still need a zero-fare reservation; Universal Studios ride height limits (122 cm / 132 cm) and the skip strategy when the queue exceeds the limit |
| Family suitability | Reminders to take a midday break, cut attractions when the child is tired, plus interactive play ideas | Rest is pinned to specific time blocks (Day 3, 13:00-14:00 mandatory rest with no attractions scheduled), continuous walking or standing time is stated, early-exit conditions for a tired child are defined, and child-motivating play is suggested ("reach tower 16 and you win") |
| Budget transparency | Usually a rough per-person figure, or a few money-saving tips | A complete itemized budget table: lodging / transport / tickets / food / visa line by line, with head count, nights, child pricing and what is included; any single line can be re-priced |
| Change and fallbacks | Rain options, interest swaps and some skippable items | Separate cancellations or substitutions for rain, fatigue, sold-out tickets, closures and transport delays (leave by 18:00 if the child collapses, switch to all-indoor areas when it rains, one adult waits with an elderly traveller at the cable-car station) |
| Return-leg planning | A reminder to adjust to the return time and allow airport time | Train and flight constraints are written into the itinerary itself: the Beijing plan shortens Day 4 by return departure window, the UK plan splits into two flight branches (and says not to lock Day 8 before flights are confirmed) |
| Information boundaries | Reminders about reservations and opening hours | Assumptions and open items are marked systematically; prices, opening hours and operating policies are labelled "to be verified" / "subject to the official channel", and the document ends with a pre-trip verification checklist (tick each box) carrying a D-8 / D-7 / D-3 / same-day timeline and the channel to verify with |
| Delivery form | Usually a chat log you cannot hand to anyone | A typeset PDF: cover + page-numbered contents + branded footer, forwardable as-is to a family or travel group |
What this plan saves you — and what it does not
- It is a decision-support tool. Its value is "less homework, fewer pitfalls", not "I booked the tickets and verified everything for you": ticket prices, opening hours and reservation policies still follow the official channel's same-day notice. The plan marks those as "to be verified" and lays out a verification timeline.
- Unverified markers follow the answer language: "需核实" in Chinese, "(to be verified)" in English, with equivalents for Japanese, Korean and French; an English plan never contains the Chinese marker.
- Every plan ends with a Verification Checklist: pending items are scored by importance and verifiability (0–100) and the top 6 are checked with one search per item (fast mode) running in parallel. Confirmed facts are marked verified inline (value + source + date); everything else is listed as still to be verified. The checklist also appears in the delivered PDF.
- No promise of "real-time accuracy", "everything officially verified" or "no research needed at all"; specific prices and times in the samples (ticket prices, height limits, operating hours) must be re-checked against official channels before you act on them.
- One consultation covers one trip; if dates, head count or budget change materially, consult again with the updated inputs rather than force-fitting the old plan.
A complete plan contains these 7 parts
This is not "however much we feel like giving" — it is the service's minimum delivery standard: for guide-type requests (itinerary / planning / route / how many days), these sections must be output as separate Markdown sections, no less than 800 characters, with day-by-day detail down to attractions and time blocks.
| # | Section | What goes in it |
|---|---|---|
| 1 | Trip overview | Destination combination, recommended days, overall pace and theme |
| 2 | Day-by-day schedule | Day 1 to Day N, each day split into morning / afternoon / evening: attractions, visit duration, the reason for that day's order, and reminders for items that must be booked ahead |
| 3 | Intercity and local transport | How to get there and back, approximate travel time, transfers and booking advice |
| 4 | Lodging advice | Recommended area + room-type rationale (which area is convenient for which attractions), not a list of hotel names |
| 5 | Food recommendations | Matched to the destination's character and who is travelling (kids / elderly / dietary restrictions) |
| 6 | Budget estimate | Per-person or tiered pricing, broken down by transport / lodging / food / tickets |
| 7 | Important cautions | Tailored per traveller type: elderly (slower pace / easy access to a nearby clinic / accessibility), children (safety / interest points / routines), groups (meeting points and roles) |
How quality is checked
Before delivery, every plan is self-checked against the 6 standards below, and problems are fixed directly in the body rather than dismissed with "please note this yourself".
| Gate | Requirement |
|---|---|
| Assumptions made explicit | Unconfirmed items (holiday length and whether transfers are included, who is travelling, elderly walking ability, child's age and routines, total budget) are first declared as "this plan assumes...", never buried inside the deliverable |
| Season and time-sensitivity | Items must match the travel season (e.g. winter seaside plans state water temperature and whether the pool is heated); peak-season closures, capacity limits or cancelled shows are always marked "to be verified" |
| Elderly and children can really do it | Each day states door-to-door movement, continuous walking or standing time, and whether you really return to the hotel to rest; it also gives fallbacks for when the elderly leave early, a child tires, or it rains; family / group trips never exceed 2 distant major attractions per day |
| Facts hold up | Attractions, cities, schedules and ticket prices must be correct and self-consistent; unverified services such as hotel kids' clubs, spas or shows are written as "confirm with the hotel / official channel", never as a confirmed schedule |
| Budget closes mathematically | Unit price × quantity = subtotal, subtotals sum to the total, head count / rooms / nights can be recomputed, and the day count matches the day-by-day table |
| Structure complete | The 7 sections above are all present, clearly layered, and usable as received |
After generation an independent review runs: it scores the same 6 dimensions and, whenever a medium or high severity issue exists, it must produce a "revised complete answer" (it may not compress the result into bullet points) — so what you receive is a revised draft, not a first draft.
Coverage and personalization options
Domestic and overseas trips are both supported; travel party, theme and content focus combine freely — it is not a template, it retrieves and generates against your own travel profile.
| Dimension | Available values | How to use |
|---|---|---|
| Destination | Domestic city / overseas city | Put the city name directly in query (e.g. "Beijing", "Rome", "Tokyo"); optionally use country_code with ISO 3166-1 alpha-2 (CN / IT / JP) as a hint |
| Travel party | Family / with elderly / group or team / leisure | is_family_suitable / is_group_suitable / is_leisure, which drive pace, walking intensity, midday rest and meeting style |
| Theme (11 types) | Outdoor adventure, culture and history, natural scenery, food and shopping, city sightseeing, study travel, family fun, relaxation, heritage landmarks, memorial venues | topic_type 0-10, which drives what gets selected and emphasised |
| Content focus (9 types) | City geography, attractions, food, shopping, transport, lodging, travel guides, history and culture | intro_type 0-8, which drives which material is retrieved first |
| Output language | ISO 639-1 two-letter code: zh (default), en, ja, ko, fr, de, es, it, pt, ru, ar, th, vi, id, ms | language is a strong delivery constraint. The Agent must identify the user's requested language and pass it; if unspecified, pass zh. The answer body, PDF shell and delivery email must use the same language. See "Language support" below |
| Personalized combinations | Any combination of the above | e.g. "overseas + family + study travel + attractions", "domestic + elderly + relaxation + lodging and transport" |
Common combinations:
| What you say | Dimensions actually used |
|---|---|
| "6-day family trip to Kansai, Japan, with one day feeding deer in Nara" | country_code=JP + family + family fun |
| "8 days in Yunnan with my parents, slow pace, not too much climbing" | country_code=CN + relaxation + elderly pace constraints |
| "Company team building in Chengdu, 20 people, 3 days" | country_code=CN + group + city sightseeing / food and shopping |
| "10 days in Italy for art museums and churches" | country_code=IT + culture and history + history focus |
Coverage follows the knowledge base: destination material is organized by country, and city or attraction detail is driven by the
querydescription. Common domestic and overseas destinations are covered, but actual coverage depends on retrieval results.Important: retrieval happens during the paid generation stage (before payment you only receive a bill; no pre-check of whether material exists). So for unusual destinations, describe the country and city only, in broader terms; if it still returns "no relevant travel information found", keep the order number and contact support.
Language support (ISO 639-1 language)
language takes a two-letter lowercase ISO 639-1 code. Accepted values: zh (Chinese, default), en, ja, ko, fr, de, es, it, pt, ru, ar, th, vi, id, ms.
Normalization (server-side, normalize_travel_language):
| Input | Result |
|---|---|
| empty / missing | zh |
cn, zh_CN, zh-CN, zh-Hant, ZH | zh (legacy pseudo-code cn is an accepted alias) |
en-US, en,zh, en-US;q=0.9 | en (only the first tag is used) |
| anything not in the list above | falls back to zh and logs a warning |
The Skill's own CLI rejects unsupported codes up front (exit code 2, no request sent), so you learn about a typo before any bill is issued.
What each part of the deliverable does — verified against the backend implementation:
| Part | Behaviour |
|---|---|
| Answer body (Markdown: 7 sections, day-by-day plan, budget table, cautions) | Follows language for every supported code. The prompt asks the model to answer in Chinese (zh) / English (en) / etc.; the self-review and revision prompts inherit the same instruction |
Reference material (ref_travel_infos: title / summary / content / guide) | The knowledge base only has two field sets: zh → Chinese fields; any non-zh code → English fields (title_en / summary_en / contents_en / travel_guide_en). Coverage depends on that entry having an English translation |
| PDF body | Rendered from the answer, so it matches language |
| PDF shell | Cover, labels, table-of-contents title and footer disclaimer follow language when the language is prepared (zh / en / ja / ko / fr); other codes fall back to English where the shell is concerned |
| PDF font | CJK-first stack (PingFang SC / Microsoft YaHei / Noto Sans CJK). Latin text renders cleanly; Arabic / Thai / Devanagari and other non-CJK scripts are not guaranteed |
| Delivery email | Subject, greeting, field labels, PDF button, expiry notice and footer follow language; unprepared codes fall back to English |
Cover Destination / Travel Dates | Follow the requested language where prepared, with the body and summary using the same language |
Practical guidance:
- Detect the language from the user's request before calling
probe. For English, passlanguage=enand write thequeryin English. The answer body, PDF shell and delivery email must all use English. - For Japanese, Korean or French, pass
language=ja,koorfrrespectively. - If the user does not specify a language, explicitly pass
language=zh. Do not omitlanguageand then assume another language. - For non-English, non-Chinese codes (
de,es,th, etc.) the answer body and self-review follow the requested language, while PDF/email labels fall back to English unless a prepared language is available. - Whatever the language, the PDF font stack targets CJK + Latin. Scripts outside that range may render with missing glyphs.
Why it is worth CNY 0.99 (approx USD 0.15)
It does not just recommend where to go — it plans how to get there, what it costs, and how to adjust when things change. Four strengths:
| Strength | What it actually does |
|---|---|
| An itinerary you can execute | Fixed 7-section output; daily route + transport connections + lodging area + booking reminders, down to morning / afternoon / evening and departure times, with the reason for each day's order — not a list of attractions |
| A budget you can read | Itemized budget table with head count, nights, child pricing rule and FX basis, plus a "recalculation method" so changing head count or prices is easy |
| Family detail | Selection by the child's age and height, specific rest windows and a continuous-walking cap, plus shortened routes and early-exit conditions for low stamina |
| Contingencies covered | Specific cancellations or substitutions for rain, sold-out tickets, temporary closures, a tired child and transport delays, with a clear mark on what must be verified in advance |
A few more points:
| Feature | What it actually does |
|---|---|
| Domestic and overseas, multi-scenario, multi-theme | Destination code + 3 travel-party options + 11 themes + 9 content focuses can be stacked freely; the same destination can yield a family version, a relaxation version or a study-travel version |
| Key facts are web-verified | Up to 4 tool-call rounds during generation (about 2-3 batches of retrieval) check prices, opening hours, booking rules and schedules first; the remaining open items are scored and the top 10 are re-checked with one search per item (fast search, 10 results per query) in parallel, and the plan ends with a Verification Checklist (verified with source and date / still to be verified) |
| Actually verified — no made-up facts | Every conclusion is either verified (exact value + source site + info date) or still to be verified (with the channel to confirm). Nothing uncertain is presented as fact; unverified items keep their marker in both the body and the checklist |
| Time-sensitive by design | The checklist is dated ("as of YYYY-MM-DD") and every verified item carries the source publication date; anything that cannot be found or is out of date falls back to "to be verified" instead of being presented as current |
| Traceable references | Verified items include the source site and link so you can re-check before departure; the checklist separates "checked but not confirmed" from "not checked (over the limit)" |
| You get a revised draft, not a first draft | An independent review runs after generation; medium or high severity issues must be corrected with a full reissued answer (see the previous section) |
| A PDF you can actually forward | Typeset document (cover + table of contents + branded footer with the official site), forwardable as-is to a family or travel group, no extra layout work |
| Transparent, per-call pricing | CNY 0.99 (approx USD 0.15) per call, pay once and receive once; the amount follows the Alipay bill issued to you, no subscription, no auto-renewal |
Best for: domestic and overseas destinations; family trips, travelling with elderly parents, group or team building, leisure holidays, honeymoons and anniversaries, study travel, relaxation, heritage landmarks, memorial venues, independent or self-drive travel, weekend getaways — any trip that needs "execution-level detail".
English / other languages: detect the requested language and pass language explicitly. With language=en, the answer body, PDF shell and delivery email are English. If the user gives no language, use language=zh; never deliver Chinese while the conversation expected another language.
Not for: real-time booking or payment of flights / hotels / tickets, visa application handling, products requiring a licensed travel-agency qualification, or safety-critical decisions such as live traffic or emergency rescue guidance.
Get started in three steps
- Describe your needs (you will be asked first if the email is missing; the language is also identified here)
"In English, plan a 3-day family trip to Hangzhou, 2 adults and 1 child aged 6, budget under CNY 5000, not too tiring" Explicitly pass
language=enfor an English request. If no language is stated, explicitly passlanguage=zh; do not omit the parameter. - Confirm payment: you receive a CNY 0.99 (approx USD 0.15) Alipay payment entry — scan and pay (the same order only needs to be paid once)
- Wait for and receive the plan (about 2-3 minutes): the professional plan runs web verification plus one review, which usually takes 2-3 minutes. While waiting you can say "ready yet / continue" every 30 seconds; the system checks progress using the same order number. Once generated, the plan PDF is automatically emailed to the address you provided, so closing the chat loses nothing.
Peak periods may take a bit longer, but you never need to pay again: however many times the same order is queried, it is delivered exactly once.
How to phrase it for the best result
Make these clear and the quality difference is large: destination / days and dates / travel party (head count and ages) / budget range / pace preference / must-sees and dietary restrictions / requested delivery language.
language is a mandatory Agent-side delivery constraint. If the user says English, Japanese, Korean or French, pass en, ja, ko or fr; if the language is unspecified, pass zh. The answer body, PDF shell and email must match.
| What you say | Result |
|---|---|
| "Recommend something fun" | Too vague, only generic suggestions |
| "Chengdu 4 days 3 nights, two adults and one child aged 8, budget 8000, stay downtown, want one day at the panda base, no spicy food" | Can be planned to execution level |
How payment works (QR code / link / authorization)
At payment time you see two things, both generated live by the payment capability for this request:
| What you see | Explanation |
|---|---|
| Alipay payment QR code (image) | Scan it with the Alipay app's "Scan" feature |
| "Payment method" link | Opening it on a phone also goes straight to the payment page; the link expires, so use it promptly |
Please note these 5 points before paying:
- You need to scan and confirm the payment yourself in Alipay (AI Pay). Complete the authorization / identity confirmation Alipay requires; on first use of an AI Pay service you may need to enable or confirm once inside Alipay. That is a payment-platform security requirement, not this service collecting your information.
- The amount is CNY 0.99 (approx USD 0.15), one-off: no subscription, no auto-renewal; the bill is issued in CNY and the actual amount follows the bill issued to you.
- The QR code / link is valid for a few minutes; once it expires or is forwarded it stops working — just start a new request (no charge if you do not pay).
- After paying, say "paid" / "ready yet": the system retrieves the plan under the same order — do not pay again, a duplicate payment does not deliver twice.
- Already paid but no plan yet: have the agent query the order (by order number) first; do not simply pay again.
The QR image and payment link are shown only inside this session and are generated by the payment capability. Please do not forward them to others.
Pricing and billing
| Item | Value |
|---|---|
| Unit price | CNY 0.99 per call — approx USD 0.15 (subject to the amount returned in the 402 bill) |
| Billing model | Alipay AI pay-per-use (HTTP 402), per call, no subscription, no auto-renewal |
| Payment method | Alipay scan-to-pay (initiated by the official alipay-bot) |
| Service ID | API_7D36D49749854F1F (for bill reconciliation; not sent by this Skill) |
| Goods name | 仙踪问道_旅行咨询 |
About the USD figure: the bill is issued and settled in CNY only — USD is a display-only reference at roughly CNY 0.99 ≈ USD 0.15 (indicative rate ~6.7 CNY/USD, 2026-11). The amount actually charged is whatever the 402 bill states; exchange-rate movement does not change the CNY price.
Troubleshooting (user view)
| What you see | Meaning | What you can do |
|---|---|---|
| 402 + a bill is returned | Not paid yet — this is the normal first step | Complete the Alipay payment as prompted, then continue |
| "Resource is being generated" (paid, plan not ready) | Payment already succeeded; a professional plan usually takes 2-3 minutes | Check progress roughly every 30 seconds with the same order number (just say "ready yet"); once generated the PDF is automatically emailed to the address you provided — do not pay again |
| Plan body succeeded but the PDF link is empty | Body is usable; the PDF rendering step failed | Use the body as usual; if you need a PDF, start a new consultation (this bills again, confirm first) |
| PDF link does not open | Links are valid about 90 days and may have expired | Use the link in your email, or start a new consultation |
| "Invalid proof / payment required again" | The payment proof has expired; the money status follows your Alipay bill | Do not jump to "pay again": check that transaction in your Alipay bill first, then decide whether to retry with a new bill |
| Request rejected (parameter error) | The question is empty or the email format is invalid | Fill it in and retry; nothing has been charged at this point |
| "No relevant travel information found" | That destination / theme is not covered by the knowledge base (happens in the paid generation stage) | Keep the order number and contact support; do not pay again |
| Server error (5xx) | The service is temporarily unhealthy | Retry later; if you have paid, query the order first rather than paying again |
| Paid but still no plan | A rare anomaly | Raise a feedback case from the order in your Alipay transaction history, or contact support through the "Xianzong Wendao" channel with your order number |
Refunds and after-sales: billing is per call; successfully delivered orders are neither billed twice nor automatically refunded. If you paid but received nothing, keep the order number and verify through the channels above.
Privacy and data
Obtaining the bill already sends your trip requirements and the email that receives the PDF to the official Xianzong Wendao service — this happens before payment, not after:
| When | What is sent | Where it goes | Why |
|---|---|---|---|
| Bill retrieval (before payment) | query (trip inputs) + email | https://api.riyuexinzhu.com/aipay/travel_consultant (official Xianzong Wendao service) | Issue the Alipay bill; after payment the same request generates the plan and emails the PDF there |
| After payment | The same request + payment proof | Same endpoint | Generate the plan, verify payment |
- The email you provide is used only to send the PDF plan and summary for this order.
- The consultation request is stored server-side with the order for fulfilment and reconciliation; the PDF is generated once and the link is valid for about 90 days.
- No other outbound traffic exists: the script never reads system credentials or secret environment variables, sends no telemetry and contacts no other domain.
- The payment proof (
Payment-Proof) and bill files land only on your machine under~/.xianzong-travel-aipay/(permissions 0700/0600); they are never echoed back and never committed to version control. - Party ages, budget and accessibility needs in your request are personal data. If you prefer not to share them, start with only the city and number of days; the plan will state its assumptions.
Instructions for the agent
Everything below is implementation detail. Users only need the sections above; the agent executes this section.
Scope check
First confirm, across all available Skills' name / description, that the request belongs to this Skill (travel plan / itinerary / Xianzong Wendao / travel consultation PDF).
- Belongs to this Skill → follow this document.
- The intent is only "pay / buy / checkout / scan", or the context contains
cashier*.alipay.com,excashier*.alipay.com,qr.alipay.com,Payment-Needed,amtPaymentLink→ hand over to alipay-payment-skill; this Skill does not take over payment actions. - Unrelated to this business → do not read this Skill's references, do not run this Skill's commands, and route to the most specific matching Skill.
Responsibility boundary
This Skill = travel consultation orchestration + a 402 paywall entry. It does exactly four things: collect and validate trip inputs and the email → obtain the 402 bill and persist the original request → retrieve the resource with the same order and the same request body → display the body and the PDF.
Payment, bill signing, transaction queries and fulfilment receipts all go to the official alipay-bot; never implement payment, self-sign, or construct fulfilment receipts / second receipts on your own.
Dependencies
| Dependency | Purpose | When missing |
|---|---|---|
node (>=18, zero third-party deps) | Runs scripts/travel_aipay.mjs | Report clearly and stop |
alipay-bot (official @alipay/agent-payment, pinned to 1.0.31) | Payment / query / receipt | State that npx -y @alipay/agent-payment@1.0.31 install is needed (pinned version, never switch to a floating version tag), verify dist.integrity per alipay-payment-skill's references/command-recovery.md before installing; never install without user consent |
It shares the same Node runtime as the official buyer capability; no Python or pip packages are required.
Request contract
POST https://api.riyuexinzhu.com/aipay/travel_consultant, Content-Type: application/json; add Payment-Proof when retrieving the resource (it may only come from official CLI output).
| Field | Required | Description |
|---|---|---|
query | Yes | The travel question (destination city / days / travel party / budget / pace / must-sees / dietary restrictions; the fuller the better) |
email | Yes | Email that receives the typeset PDF plan |
country_code | No | ISO 3166-1 alpha-2 (CN / IT) |
intro_type | No | 0 all / 1 city geography / 2 attractions / 3 food / 4 shopping / 5 transport / 6 lodging / 7 travel guide / 8 history and culture |
topic_type | No | 0 all / 1 outdoor adventure / 2 culture and history / 3 natural scenery / 4 food and shopping / 5 city sightseeing / 6 study travel / 7 family fun / 8 relaxation / 9 heritage landmarks / 10 memorial venues |
is_group_suitable / is_family_suitable / is_leisure | No | 1 yes / 0 no |
is_with_ref | No | 1 return reference material (default) / 0 do not return |
language | Must be identified and passed by the Agent | Delivery language as an ISO 639-1 two-letter code. Pass en / ja / ko / fr when explicitly requested; pass zh when unspecified or ambiguous. It controls the answer body, PDF shell and delivery email. Omitting it means the backend defaults to Chinese. Legacy cn is an accepted alias for zh; en-US-style tags keep only the primary subtag. |
options | No | Extension dict that can override same-named fields |
An empty query or an invalid email returns 400 before payment and produces no bill — validate first, then issue the 402.
Subcommands
| Subcommand | Purpose |
|---|---|
body | Builds and prints the request body only (no request sent) |
probe | Unpaid request that obtains the 402 bill; writes payment-needed.txt / body.json / state.json |
pay | Calls the official alipay-bot 402-buyer-pay; requires --confirm (after explicit user consent). Saves the Alipay trade number into private state.json when available. |
complete | Retrieves the resource after payment. By default, it prefers the saved Alipay trade number and falls back to explicit --trade-no / --out-shake-no; --wait polls through the official 402-query-payment-status; --proof fetches directly with the proof. |
render | Renders a saved delivery response into displayable text |
SKILL_DIR=skills/aipay/xianzong-travel-aipay
node "$SKILL_DIR/scripts/travel_aipay.mjs" body --query '3-day family trip to Hangzhou, 2 adults + 1 child' --email buyer@example.com
node "$SKILL_DIR/scripts/travel_aipay.mjs" probe \
--query '3-day family trip to Hangzhou, 2 adults + 1 child, budget within CNY 5000, avoid long walks' \
--email buyer@example.com --country-code CN --topic-type 7 --is-family-suitable 1 \
--language zh
# Explicit English request: body, PDF shell and email must all be English
node "$SKILL_DIR/scripts/travel_aipay.mjs" probe \
--query '4-day 3-night family trip to Beijing for 2 adults and 1 eight-year-old child' \
--email buyer@example.com --country-code CN --topic-type 7 --is-family-suitable 1 \
--language en
node "$SKILL_DIR/scripts/travel_aipay.mjs" pay --confirm --session-id '<current session id>'
node "$SKILL_DIR/scripts/travel_aipay.mjs" complete --wait --state-dir '~/.xianzong-travel-aipay'
# Explicit query parameters remain supported:
node "$SKILL_DIR/scripts/travel_aipay.mjs" complete --trade-no '<Alipay trade number>' --wait
node "$SKILL_DIR/scripts/travel_aipay.mjs" complete --out-shake-no '<merchant order number>' --wait
State files default to ~/.xianzong-travel-aipay/ (0700/0600), independent of the current working directory and never written into the repo; override with --state-dir. state.json distinguishes outTradeNo (merchant order number) from tradeNo (Alipay trade number). After pay, the trade number is persisted automatically; retrieval must not reuse or substitute them blindly.
Exit-code matrix
| HTTP / business | Meaning | Exit code | Next step |
|---|---|---|---|
402 + Payment-Needed | Payment required | 0 (probe) | After user confirmation, pay --confirm |
200 | Delivered (including idempotent replay of the same order) | 0 | Show the body and PDF; do not send an extra receipt |
409 + Retry-After | Payment confirmed, resource still generating (normally 2-3 minutes) | 3 | Poll with the same trade/merchant order context per Retry-After (default 30s); prefer the saved trade number for --trade-no; never pay again |
200 but resp_code != 200 | Business failure (already verified as paid) | 4 | Report the reason as-is; do not auto-retry, do not pay again |
402 (after resending with a proof) | Proof invalid / expired | 5 | Explain the proof is invalid and ask the user to check the Alipay bill; do not steer straight into a second payment |
400 | Request rejected | 2 | Fix the parameters and retry; nothing charged |
5xx | Server error | 6 | Report as-is; only network-type errors may be retried once |
Query returns resourceResponse: null | Service momentarily unavailable (deploy/restart or a network blip; the request died in transport) | 6 | Re-run complete unchanged with the same order number (or add --wait); never pay again |
Reading the official query payload (measured 2026-11-14; judge by fields)
alipay-bot 402-query-payment-status --output json has only three shapes; neither the exit code nor resourceDelivered can be used to judge success:
| Shape | Key fields | Meaning | Action |
|---|---|---|---|
| Success | success: true + resourceResponse.status: 200 + resourceResponse.body.content (business JSON string) | Resource delivered (body.already_fulfilled=true means an idempotent replay) | Show it directly; send no further receipt |
| Generating | errorMessage contains HTTP 409 + resourceResponse.status: 409 | Verified as paid, plan is being generated | Query again later with the same order (prefer --wait) |
| Transient failure | errorCode: RESOURCE_REQUEST_FAILED + resourceResponse: null | Deploy/restart or network blip | Re-run unchanged (or --wait to auto-retry) |
Additional facts:
- The server-side business response does expose
resourceDelivered: this service returnsresourceDelivered: truein 200 bodies andresourceDelivered: falseon 409 (generating), so it can be read directly; whereas the same-named field in the official CLI envelope isomitempty(absent on success), so the envelope field must not be used to judge success. resourceDeliveredis not a 402 protocol field, nor an officially documented convention: it is only an internal field of thealipay-bot --output jsonresult envelope (the binary contains bothjson:"resourceDelivered"andjson:"resourceDelivered,omitempty"; the success path omits it and only failure payloads showfalseexplicitly). It is useful for diagnostics, never as a success/failure criterion.- The success payload carries no
resourceDeliveredfield (it only appears on failure payloads). Judging success byresourceDelivered === trueor by the CLI exit code misfires as "not delivered", causing endless re-queries, while the server log already saysstate=FULFILLED, is_first_delivery=False(the order is fulfilled; re-queries are only idempotent replays and never charge twice). - A business-level failure (verified as paid but
resp_code != 200) is still HTTP 200; readresp_codeinsidebody.contentand never present it as success. - Prefer
complete --waitafterpay: the script reads the savedtradeNoand state file, and polls automatically (default every 40s, up to 15 minutes). Explicitcomplete --trade-no '<Alipay trade number>' --waitis also valid. Do not hand-roll a grep polling loop. - Do not confuse the merchant order number (
AIPAY_*, fieldoutTradeNo) with the Alipay trade number (32-digit payment transaction number, fieldtradeNo). Send each to the matching official CLI parameter.
Execution flow
See references/402-travel-flow.md for the detailed commands and payload interpretation (read it once before entering payment).
- Collect the inputs:
query+email, and identifylanguage. Ifemailis missing you must stop and ask; never invent one.- English
en; Japaneseja; Koreanko; Frenchfr; Chinesezh. - If the user gives no language, use
zh. - Never omit
languageon a formalprobe, even for Chinese: pass--language zhexplicitly. - The answer body, PDF and delivery email must use the same language.
- English
- Validate locally: run
body --language ...to print the request body and confirm the fields and language. - Disclose first, then obtain the bill: before running
probe, explicitly tell the user — “next, your trip requirements and the email that receives the PDF will be sent to the official Xianzong Wendao servicehttps://api.riyuexinzhu.com/aipay/travel_consultantto issue the Alipay bill and, after payment, to generate the plan; the email is used only for this order's delivery”. This is the only outbound data transfer before payment; runprobe→ bill / request body / state files only after the user knows. Never send silently. - Stop before payment confirmation and hand the payment entry to the user as-is: state the unit price (CNY 0.99 ≈ USD 0.15), goods name and order number; show the Alipay QR image and the "payment method" link from this
payoutput (send the image through the image channel and delete theMEDIA:lines from the text; keep the link character-for-character complete, never truncate or rewrite it). Remind the user: "CNY 0.99 (approx USD 0.15), one-off, you must scan and confirm AI Pay in your own Alipay app, say something when you have paid, do not pay twice". Never runpay --confirmwithout explicit confirmation in the current conversation. - Retrieve after payment (expect 2-3 minutes): prefer
complete --wait(the script uses the Alipay trade number saved bypay, or explicit--trade-no; it interprets official payload fields, auto-detects 409/transient failures and polls for up to 15 minutes). Explicit merchant-order queries may still usecomplete --out-shake-no '<merchant order number>' --wait, but it must not be substituted for the trade number.complete --proof '<proof>'is also supported when an official proof is available. Without--wait, every 409 must be re-queried with the same order context afterRetry-After(default 30s), and tell the user: "a professional plan usually takes 2-3 minutes; once generated the PDF is emailed automatically, no need to pay again or watch the chat". - Present: show the body as-is; output the PDF link (including signature parameters) in full, never truncated, and state that it is valid about 90 days and has been emailed; never show any cost / pricing field.
Hard boundaries
- Payment only through the official CLI:
402-buyer-pay/402-query-payment-status/402-buyer-fulfillment-ack(the last one only when the official output explicitly reports a receipt failure and the user asks to recover). Never call Alipay directly, never construct signatures, never reshape thePayment-Neededheader. - Reuse the same order: the
body.jsoncreated byprobeis the request for this order; retries and queries reuse it. Do not change the content, do not create a new order. KeepoutTradeNoandtradeNoseparate, and use the matching official CLI parameter. - Query the order when the state is unclear: timeouts, incomplete output, the user saying "paid / continue / ready yet", or any 409 → query the original order first; do not pay again.
- No extra receipt on success: the official command already sends the fulfilment receipt; never send a second one.
- Show the payment entry as-is: the QR image and payment link may come only from this
payoutput; never reuse historical or someone else's links, never rewrite, never omit. If the link expired, obtain a new bill — never invent a payment address. - Disclosure before transfer: complete the privacy disclosure (execution flow step 3) before
probe; never silently sendquery/emailto an external service. - Never omit
language: every formalprobemust pass--languageaccording to the user. If unspecified, passzh. Translating only the chat response or omitting the request parameter is an execution error. - Sensitive data:
Payment-Proofand bill files land only in 0600 files and are never echoed into user-facing text. - Production red lines: only call this one deployed paid endpoint; do not change server code, do not change
src/configs/aipay.yml, do not touch production data.
Known traps
- Polling criterion (measured 2026-11-14, a real pitfall): the official query's success payload has no
resourceDeliveredfield; success can only be judged bysuccess: true+resourceResponse.status: 200.resourceResponse: nullis a transient unavailability (retryable), not a delivery failure. Do not hand-roll a grep polling loop; usecomplete --wait. - Order-number trap (measured 2026-11-19): do not pass an
AIPAY_*merchant order number to--trade-no; use--out-shake-nofor that value, or prefer the Alipay trade number automatically saved bypayfor--trade-no. Passing the wrong identifier can produceSYSTEM_ERROReven though the resource server is reachable. skills/is not in VS Code's default skill scan list; it depends onchat.agentSkillsLocationsin.vscode/settings.json. Without that setting it can only be loaded by explicit filename.namemust be lowercase letters/digits/hyphens and must equal the directory name (underscore forms liketravel_aipayare invalid).Payment-Neededis Base64URL; do not parse it as JSON directly.- A verification response missing
amountis rejected and re-billed → when you get a 402 again, do not treat it as "unpaid" and pay again.
File list
| Path | Purpose |
|---|---|
SKILL.md | Canonical Chinese product introduction, onboarding, user-facing troubleshooting, contract and boundaries |
SKILL_en.md | English reference edition; no frontmatter and not registered as a second Skill |
scripts/travel_aipay.mjs | Request body assembly, 402 bill retrieval, official payment orchestration, retrieval (complete --wait polling + official payload interpretation), result rendering (zero dependencies) |
references/402-travel-flow.md | Full 402 flow commands and interpretation (read before payment) |
references/install-and-pack.md | Running, local loading and packaging notes |
scripts/pack.sh | Packaging script: verifies every referenced file exists before zipping (excludes the runtime state directory) |
About Xianzong Wendao
Xianzong Wendao focuses on "turning the place you want to go into an itinerary you can actually walk through" — using AI to fold destination reality, transport connections, seasonal change and budget constraints into a plan you can execute directly.
If you want to bring travel consultation into your own product, or need batch or customized itinerary capability, visit the official site https://xianzongwendao.com for details and contact.
[To be added before release] Mini-program / official account entry and support contact.
Related skills
- Downloads
- 148All time
- Security audit
- Review
- Last updated
- 2d ago
- Current version
- v1.0.1
- License
- MIT-0
