用途
该技能面向 Xendit 支付网关的集成工作，用于搭建、构建、调试和讲解 Xendit 相关集成。它按任务形态组织内容，建议先判断任务类型，再只加载相关的参考文档，避免一次性引入全部资料。
主要能力与参考文档
技能将常见任务映射到对应参考文件：
- Payments API 或结账流程：阅读 payments-api.md。
- Webhook 接收器、重试、重复事件或回调令牌校验：阅读 webhooks.md。
- 市场/平台、子账户、分账费用、余额转账或 for-user-id 路由：阅读 xenplatform.md。
- 首次项目搭建、API 密钥、仪表盘前置条件或渠道激活：阅读 setup-checklist.md。
- 注册、凭据、环境变量与仪表盘设置摘要：阅读 account-setup.md。
- 端点/类别查找与实时文档链接：阅读 source-map.md。
集成规则
技能列出的集成规则包括：
- 密钥请求与 Webhook 处理使用服务端代码。
- 使用 HTTP Basic Auth 认证 Xendit API 调用，用户名为密钥 API key，密码为空。
- 手动构建 Authorization: Basic ... 时，在 Base64 编码前保留末尾冒号。
- 将 reference_id 视为商户幂等/关联键；存储 API 返回的 Xendit ID。
- 绝不单独信任客户端支付完成状态；应依据经过验证的服务端状态或 Webhook 状态履行订单。
- 通过 Xendit 对象/事件标识（如 payment_id、capture_id 或产品特定 ID）使 Webhook 处理器幂等。
- Webhook 端点快速返回 2xx 响应，然后将较重的工作异步处理。
- 不假设 Webhook 顺序；当事件乱序到达时，依据当前对象状态进行对账。
当前 API 形态
新的收款优先使用 Payments API v3：
- POST /v3/payment_requests：创建支付意图/请求。
- POST /v3/payment_tokens：保存支付信息以便后续复用。
- /refunds：退款支付资金。
常见支付请求类型：
- PAY：收取一次支付。
- PAY_AND_SAVE：收取一次支付并保存可复用的支付信息。
- 带令牌的 PAY：使用之前保存的支付令牌收款。
- REUSABLE_PAYMENT_CODES：通过可复用代码或静态渠道设置收取多笔支付。
使用方式（编码前确认）
在针对 Xendit 编码之前，技能建议确认：
- 确定产品路径：Payment Sessions/Components、Payments API v3、Payment Links、Subscriptions、Payouts 或 xenPlatform。
- 确认国家、货币、渠道与渠道属性。
- 确认 live 与 test API key、密钥权限以及回调/Webhook URL。
- 确认流程是否需要客户通过返回的 actions 操作，或使用托管/嵌入式结账。
- 确认状态映射与订单履行状态机。
- 确认 Webhook 令牌校验与幂等存储。
- 对于 xenPlatform，确认主账户与子账户归属以及路由 header/body 字段。
验证
对于面向生产的回答，如果确切的字段名、枚举值或端点 schema 很重要，应验证实时文档。Xendit 文档处于活跃状态且可能变化；该技能提供稳定的工作流规则与来源链接，而非完整的冻结 OpenAPI 副本。
限制
资料未提供具体的收费、价格、平台支持范围或效果数据；这些内容暂未提供。技能本身不包含完整的 OpenAPI 规范副本，涉及精确 schema 时需查阅实时文档。