修改钱包额度
修改钱包额度允许更改现有钱包的后付费信用额度金额。
Request
ENDPOINT
/wallet/WALLET_KEY/wallet_limit/WALLET_LIMIT_KEYMÉTODO
PATCH路径参数
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
wallet_key * | uuidv4 | UUID v4 格式的钱包唯一密钥 | 36 |
wallet_limit_key * | uuidv4 | UUID v4 格式的钱包额度唯一密钥 | 36 |
Request Body
{
"limit_amount": 10000.00
}
请求体参数
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
limit_amount * | float | 新的后付费信用额度金额 | - |
说明
- 新额度金额必须大于或等于已用额度(
used_limit) - 只能更新
postpaid_credit_limit类型的额度 - 只有
default类型的钱包可以更新其额度 - 额度更新也会同步更新卡片服务中的额度
Response
STATUS
200Response Body:钱包额度已更新
{
"wallet_limit_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"limit_type": "postpaid_credit_limit",
"limit_amount": 10000.00,
"used_limit": 2500.00
}
响应体参数
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
wallet_limit_key * | uuidv4 | UUID v4 格式的已更新额度唯一识别密钥 | 36 |
limit_type * | string | 已更新的额度类型 | limit_type 枚举值 |
limit_amount * | float | 更新后的新后付费信用额度金额 | - |
used_limit * | float | 更新时的已用额度金额 | - |
limit_type 枚举值
| 枚举值 | 描述 |
|---|---|
| postpaid_credit_limit | 后付费信用额度 |
错误响应
STATUS
4xxResponse Body: Error
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {}
}
HTTP 代码status | QI 代码code | 标题title | 描述(英文)description | 描述(葡文)translation |
|---|---|---|---|---|
| 400 | CIN000110 | Bad Request | New limit amount is less than used limit | Novo valor do limite é menor que o valor utilizado |
| 400 | CIN000111 | Bad Request | Error while updating postpaid wallet limit in card service, try again in a few minutes. | Erro ao atualizar limite de carteira pós-pago no serviço de cartão, tente novamente em alguns minutos. |
| 400 | CIN000112 | Bad Request | Requester postpaid limit exceeded for this client | Limite das carteiras pós-pagas do cliente excedido |
| 403 | CIN000108 | Forbidden | Wallet type payroll is not allowed for this operation | Tipo de carteira payroll não é permitido para esta operação |
| 403 | CIN000109 | Forbidden | Wallet limit type payroll_withdraw_limit is not allowed for this operation | Tipo de limite de carteira payroll_withdraw_limit não é permitido para esta operação |
| 404 | CIN000007 | Wallet not Found | Wallet with key: e91d68d4-2904-4f9d-a6ef-50c82c34531e was not found | Carteira com a chave: e91d68d4-2904-4f9d-a6ef-50c82c34531e não foi encontrado |
| 404 | CIN000107 | Not Found | Wallet limit not found | Limite de carteira não foi encontrado |