该技能用于 Omise 支付网关的集成工作,面向马来西亚商户(账户国家为马来西亚,资金货币为 MYR)。使用前应先阅读 references/omise-api.md,该文件是入口,涵盖环境、认证、API 版本、扣款流程、Webhook 签名、状态、金额规则、速率限制、IP 及完整端点目录,并链接到各主题文件。
主要能力:提供 Charges API(创建、捕获、撤销、过期、卡令牌、Omise.js、3-D Secure)、马来西亚支付方式(FPX、DuitNow OBW、DuitNow QR、Touch 'n Go、Boost、GrabPay、ShopeePay、Maybank QR、Atome、Google Pay、分期付款、Source API 字段、银行代码、限额)、Webhook(签名验证、事件列表、Events API、动态 Webhook)、退款与争议、定期扣款(Customers、Cards、Schedules、Occurrences)、结算与报告(Balance、Transactions、Transfers、Recipients、马来西亚银行代码、收据、搜索)、支付链接 API 以及测试与错误处理等参考文档。
使用方式:工作流程包括识别测试或生产模式;确定集成界面(Omise.js 预建表单、自定义表单、仅服务端 Source 扣款、移动 SDK、插件、Payment Links+ 或 Schedules);确认支付方式已在账户启用并通过 GET /capability 检查可用性;创建本地待处理订单;浏览器端创建卡令牌或 Source;服务端使用密钥创建扣款并存储 chrg_... ID;处理 pending 状态与 authorize_uri 重定向;通过验证 Webhook 签名并重新获取扣款来确认结算;实现幂等和对账任务。
适用场景:马来西亚商户的 Omise 支付集成开发、调试、审查和解释工作。
限制:多币种不适用于马来西亚账户,仅支持 MYR;未提供具体收费信息,需参考官方定价页面;部分账户相关设置(3DS 启用、支付方式启用、限额、持有期、费用、Webhook 重试行为)取决于账户配置,暂未提供。