用途：指导在应用中安全集成 Moyasar（沙特支付网关）的 REST API，覆盖支付、发票、令牌、打款、结算与 Webhook 等场景。
主要能力：创建、查询、列表、更新、退款、捕获、作废支付；托管发票与支付链接；卡令牌化与保存卡扣款；打款账户与批量打款；结算与对账；Webhook 事件通知与校验；错误处理与重试。
必要用法：基础地址为 https://api.moyasar.com/v1（聚合转账用 https://apimig.moyasar.com/v1）。仅 HTTPS，JSON 请求体。金额为最小货币单位的整数，如 1.00 SAR → 100。认证用 HTTP Basic，API Key 作用户名、密码留空：curl https://api.moyasar.com/v1/payments -u sk_test_xxxxxxxx:。密钥分 pk_（可前端，仅创建支付/令牌）与 sk_（仅后端，全部操作）。创建支付时自行生成 UUID v4 作为 given_id 实现幂等，仅在 5xx、网络错误或超时时用同一 given_id 重试。
适用场景：网页或移动端卡支付、3-D Secure、先授权后捕获、无前端支付链接、退款、对账与打款。
限制与安全：卡数据不得经过商户后端，须由客户端用 pk_* 直连 Moyasar；sk_* 严禁出现在前端、仓库或日志，泄露须立即在后台重置。回调跳转不可信，必须用 sk_* 在服务端重新获取支付并核对 status、amount、currency 后才标记已付；HTTP 201/200 不代表已支付，须判断 status 字段。Webhook 须快速返回 2xx、校验 secret_token 并保证幂等，同一事件可能重投最多 5 次。发票金额最小为 100。具体端点字段与状态请查阅对应 references 文件，资料未提供的内容暂未说明。