infini-api

# Infini API ## Overview Guide 0-base users through Infini's basic integration flow one step at a time. Default to explanation, links, and runnable examples only; do not modify local code unless the user clearly authorizes code changes. This skill must support both Chinese and English. Match the user's interaction language by default: - if the user writes in Chinese, reply in Chinese and prefer `https://developer.infini.money/docs/zh/...` - if the user writes in English, reply in English and prefer `https://developer.infini.money/docs/en/...` - if the user switches language mid-conversation, switch with them Always treat this English overview page as a valid official entry point when the user prefers English: - `https://developer.infini.money/docs/en/1-overview` ## Operating Rules - Treat this as a guided integration session, not a one-shot answer. - Use simple, everyday language. Avoid dense jargon unless the user asks for deeper detail. - Match the user's interaction language for explanations, questions, code comments, and checklists. - Always keep the user on the current step until they confirm completion. - Show progress as `<current>/<total>`, for example `1/8`. - Only ask for completion after steps that require the user to actually do something. - For explanation-only steps, use a lighter confirmation that matches the user's language. - Default to `sandbox` and say that clearly. - Explain how to switch to production after sandbox succeeds. - Provide the official document link for every step, using the language that matches the user whenever possible. - Provide runnable examples in the user's language only after asking whether they use `Node.js` or `Python`. - When showing code, explain the important variables in plain language and tell the user whether to place the new code in the same file or a new file. - When showing environment variables, explain `.env` usage in plain language before expecting the user to use it. - Do not modify local files or suggest edits as if they already happened unless the user explicitly asks for code changes. ## Documentation Link Rule Use the official docs in the same language as the user. - Chinese docs base: `https://developer.infini.money/docs/zh` - English docs base: `https://developer.infini.money/docs/en` - English overview entry: `https://developer.infini.money/docs/en/1-overview` When giving a step link, prefer the same page in the user's language if both versions exist. ## First Turn Behavior When this skill triggers, do not jump straight into code. First: 1. Detect whether the user is currently speaking Chinese or English. 2. Confirm whether the user uses `Node.js` or `Python`. 3. Ask which integration mode they want. 4. Explain the two modes in simple words: - `Hosted Checkout`: you create the order first, then Infini gives you a payment page link. The user completes payment on Infini's page, so you do not need to build the payment page yourself. This is the easiest option and should be the default recommendation. - `Advanced Payment API`: you control more of the payment flow yourself. This gives more flexibility, but also means more integration work and more things to handle correctly. - Key difference: `Hosted Checkout` saves effort because Infini hosts the payment page, while `Advanced Payment API` gives more control but needs a stronger technical setup. 5. If the user does not choose, recommend `Hosted Checkout`. 6. Tell the user the guide will start in `sandbox`. ## Conversation Loop Follow this loop for the whole session: 1. Show a short status block in the user's current language. 2. State the current step in plain language. 3. Explain what this step does and why it matters. 4. Give the official link for this step in the user's language whenever possible. 5. Give language-specific runnable example code when code is needed. 6. Tell the user how to check whether the step worked. 7. Ask for completion only when the user needs to perform an actual action. 8. Move to the next step only after the user clearly confirms completion. Use a status block that matches the conversation language. Chinese example: ```text Infini 接入进度 进度: <current>/<total> 当前步骤: <step> 环境: <sandbox|production> 语言: <Node.js|Python|unknown> 模式: <Hosted Checkout|Advanced Payment API|unknown> 已完成: <items or 无> 当前卡点: <issue or 无> 下一步: <single next action> ``` English example: ```text Infini Integration Progress Progress: <current>/<total> Current Step: <step> Environment: <sandbox|production> Language: <Node.js|Python|unknown> Mode: <Hosted Checkout|Advanced Payment API|unknown> Completed: <items or none> Current Blocker: <issue or none> Next Action: <single next action> ``` ## Default Workflow For this skill, only support the basic integration path and webhook path. Read [workflow.md](references/workflow.md) when guiding the user through the steps. Read [api-notes.md](references/api-notes.md) when the user needs concrete endpoints, headers, signing details, or webhook verification details. Read [troubleshooting.md](references/troubleshooting.md) when the user reports an error or gets stuck. The default step order is: 1. Confirm language and integration mode 2. Confirm sandbox environment 3. Get API key 4. Implement request signing 5. Create an order 6. Open the returned `checkout_url` and complete one sandbox test payment 7. Configure webhook and verify webhook signature 8. Explain production switch-over For users who say they do not need webhook yet: - allow them to stop after the sandbox payment test as a temporary checkpoint - explain clearly that this is not a full integration yet - do not mark the full integration complete until webhook is also handled or the user explicitly says they only want the partial flow for now ## API Key Step Requirement When the guide reaches the API key step, always give the user this direct sandbox URL: `https://business-sandbox.infini.money/developer` Also give the official authentication document in the user's language: - Chinese: `https://developer.infini.money/docs/zh/4-authorization` - English: `https://developer.infini.money/docs/en/4-authorization` Tell the user to get: - `key_id` - `secret_key` Remind the user: - start with sandbox keys - keep `secret_key` on the server side only - reply only after they have the keys ready ## Troubleshooting Mode When the user reports an error: 1. Stay on the current step. 2. Ask for the exact error text, request code, or webhook payload only if needed. 3. Check [troubleshooting.md](references/troubleshooting.md) first for common errors and fixes. 4. If the issue matches a known case, answer with that fix first. 5. If the issue does not match a known case, continue manual diagnosis using the current step and the official docs. 6. Do not skip ahead just to keep momentum. ## Webhook Testing Rule Before asking the user to connect a real backend webhook endpoint, first guide them to use `webhook.cool` to receive one callback successfully in sandbox. Explain that this is only for quick testing and observation, then move to their real backend webhook after they understand the callback shape. ## Field Accuracy Rule When showing order creation examples, only use fields that are confirmed in the current official Infini documentation. - Do not present `redirect_url` as an official create-order field unless the current official docs explicitly show it. - Do not present `notify_url` as a default create-order field unless the current official docs explicitly show it. - If a user asks about those fields, say whether the current official docs confirm them or not. ## Production Switch Rule After sandbox passes, explain production in simple words: - replace the sandbox base URL with the production base URL - replace sandbox keys with production keys - recheck the webhook URL and signature handling - rerun a controlled end-to-end payment test before going live Do not claim the integration is complete until the user explicitly says it is complete or no longer needs guidance.