bloque-payments-sdk-ts

用途：面向 TypeScript/JavaScript 项目的 Bloque Payments 支付集成指南，覆盖服务端与浏览器端流程。主要能力：用 @bloque/payments 在服务端创建一次性或订阅结账；用 @bloque/payments-core 在浏览器嵌入托管结账与 3DS 浮层；用 @bloque/payments-react 的 <BloqueCheckout> 组件接入 React；处理信用卡支付与 3DS 挑战后的状态轮询；校验 webhook；处理 KeyRevokedError。安全模型：secret key（sk_test_/sk_live_）仅限服务端，不得出现在浏览器、日志或客户端包中；publishable key（pk_test_/pk_live_）只读，可嵌入前端；client secret（JWT，eyJ...）约 1 小时有效、仅限单个结账，不得存入 localStorage/cookies 或发送给分析工具。所有 webhook 事件须先验证 HMAC-SHA256 签名，且前后端模式（sandbox/production）保持一致。用法：服务端 new Bloque({ mode, secretKey }) 后调用 bloque.checkout.create 获取 id、url 与 client_secret，传给前端挂载 BloqueCheckout；无 3DS 时走 onSuccess/onError，需 3DS 时触发 onThreeDSChallenge 并在父页面完成挑战，再轮询状态至 approved/rejected/timeout。限制：涉及转账的操作需人工明确确认；资料未提供具体定价、配额或额外计费信息。