添加或更新计费费率
需要验证签名
接口描述
添加或更新指定场景的手续费费率
提示
- 调用此接口前,需提前联系PingPong产品进行沟通确认,由PingPong配置该接口功能的支持。
- 若客户首次配置该使用场景费率,则进行添加,否则进行更新。
请求头
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | M | access_token |
| Content-Type | string | M | application/json |
请求参数
| Parameter | Type | Required | Description |
|---|---|---|---|
| partner_order_id | string(64) | M | 合作伙伴请求单号,唯一幂等。 |
| client_id | string(64) | M | 注册PingPong返回的客户ID |
| scene | enum | M | 使用场景,VA入账:INBOUND_VA ,暂只支持VA入账 |
| rate | decimal(18,2) | M | 百分比费用,必须小于1。例如费率为0.3%,传0.003 |
| effective_time | long | O | 生效时间,13位时间戳,精确到毫秒 ,默认当前创建时间 |
| expiration_time | long | O | 过期时间,13位时间戳,精确到毫秒 当前默认为为最大时间:2037-12-31 23:59:59对应的时间戳 |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| partner_order_id | string(64) | M | M |
| status | string(64) | M | M |
返回示例
- 成功
- 失败
{
"code": 200,
"data": {
"partner_order_id": "PO20220620151628",
"status": "SUCCESS"
},
"message": "SUCCESS"
}
{
"code": 900000,
"data": null,
"message": "system error"
}
错误码
| 返回码 | 描述 | 解决方案 |
|---|---|---|
| 900000 | system error | 系统错误,请联系PingPong技术人员核查 |
| 900001 | repeated request | 重复单号请求,请查询订单是否已存在 |
| 900002 | illegal param | 参数有误,请根据提示更正信息 |