用途：把 Prava 支付能力集成进使用 @prava-sdk/core 与 Merchant Session API 的 Web 应用，同时确保原始卡数据、商户密钥和一次性凭证不跨越错误的信任边界。若由 AI 智能体操作 Prava CLI，应改用单独的 prava-pay 技能。
主要能力：服务端调用 POST /v1/sessions 创建会话（自定义结账或 quote 结账），支持嵌入 iframe（integration_type: "embedding"）与托管/新标签页（"full_checkout"）两种呈现；通过支付结果轮询取回令牌、动态 CVV 与有效期，经处理器扣款后调用 report-status 上报真实结果；另支持仅授权的 mandate_setup 授权与后续扣款。
必要用法：先读 references/session-api-reference.md、sdk-api-reference.md、integration-flow.md、test-data.md，复用 templates/nextjs、express、vanilla 的逻辑并适配自身框架。安装命令为 npm install @prava-sdk/core。商户密钥 sk_* 只留在服务端，不得进入浏览器；会话须在已认证的应用服务端创建，用户、金额、币种、目标商户与商品均取自信任状态；iframe_url 须原样传入，不得重建或替换其 session 参数。测试密钥配沙箱地址 https://sandbox.api.prava.space，正式密钥配 https://api.prava.space。
关键限制：自定义结账当前只支持一个 purchase_context 条目；quote 模式须有通过 Prava shop 流程取得的 quote_id，且金额币种须与报价完全一致，否则可能返回 409 QUOTE_SESSION_MISMATCH；awaiting_result 即表示凭证就绪，不应等待 completed 再扣款；处理器扣款必须幂等，按 txn_ref_id 做持久化声明；必须上报真实 APPROVED/DECLINED；每条结账尝试只创建一个会话，放弃的会话需调用 revoke；mandate_setup 意图不产生即时凭证，不走上述轮询。
其它：user_email 须为可路由的 ICANN 域名，merchant_details.url 须为公开 HTTPS、非 IP 主机；currency 受支持列表限制。沙箱测试只能使用 Prava 分配的测试卡，首次在新设备运行可能包含设备绑定 OTP。缺失事实：具体收费、价格与完整集成步骤细节暂未提供。