Table of Contents
2.5 金额、糖果与状态值【已开发,待测试】
- APP 对外响应中的支付金额、订单金额、退款金额、提现金额和收入金额统一使用元单位字段,优先命名为
*_amount,值为固定两位小数字符串,例如"10.00"。 - 数据库字段、内部计算、后台配置保存和请求参数仍可使用分单位字段,例如
amount_cent、paid_amount_cent、refund_amount_cent;分字段不得作为 APP 展示响应的默认口径。 - 糖果使用 Decimal 或整数糖果字段,例如
candy_amount、price_candy_amount、refund_candy_amount。 - 接口状态值统一使用 SQL 中的
tinyint或字符串字段原值,不再把业务状态转换为英文枚举。 - 单号字段统一优先返回 SQL 中的
*_no字段,例如order_no、transaction_no、recharge_no、booking_no、refund_no。
说明:当前已开发接口已按上述字段口径输出;视频通话、福利、收入、提现和退款详情/回调模块已按本节口径完成基础实现并等待联调,微信/支付宝主动退款请求和异步补偿入口已完成代码封装,仍需在真实渠道环境继续验收。