跳到主要内容

申请修改 Pix 限额

Request​

ENDPOINT
/baas/pix/limits/ACCOUNT_KEY
MÉTODO
POST
Request Body
{
    "daily_amount_limit": 2000.00,
    "nightly_amount_limit": 1000.00,
    "self_daily_amount_limit": 1500.00,
    "self_nightly_amount_limit": 500.00
}

Body Params​

字段类型描述
daily_amount_limitfloat不同账户持有人日间 Pix 转账限额
nightly_amount_limitfloat不同账户持有人夜间 Pix 转账限额
self_daily_amount_limitfloat相同账户持有人日间 Pix 转账限额
self_nightly_amount_limitfloat相同账户持有人夜间 Pix 转账限额
日间时段

日间时段计算的是 06:00 至 20:00 之间的转账。

注意

提高 Pix 限额的申请需要 48 小时 的 SLA 来审批。

降低 Pix 限额的申请将立即审批并执行。

如果达到 48 小时 的 SLA 仍未获批准，该申请将以原因 Tempo de avaliação expirado.（评估时间已过期）自动拒绝，并向申请人发送拒绝 webhook（参见 Webhook Request Rejected Body）。

Response​

STATUS
200
Response Body
[
	{
		"account_digit": "5",
		"account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
		"account_name": "Default",
		"account_number": "26709",
		"amount_limit": 2000.0,
		"event_type": "pix_limit_request",
		"limit_type": "daily",
		"owner_document_number": "63602991000100",
		"request_status": "pending_approval",
		"requester_document_number": "77669728833"
	},
	{
		"account_digit": "5",
		"account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
		"account_name": "Default",
		"account_number": "26709",
		"amount_limit": 1000.0,
		"event_type": "pix_limit_request",
		"limit_type": "nightly",
		"owner_document_number": "63602991000100",
		"request_status": "pending_approval",
		"requester_document_number": "77669728833"
	},
	{
		"account_digit": "5",
		"account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
		"account_name": "Default",
		"account_number": "26709",
		"amount_limit": 1500.0,
		"event_type": "pix_limit_request",
		"limit_type": "self_daily",
		"owner_document_number": "63602991000100",
		"request_status": "pending_approval",
		"requester_document_number": "53417895200"
	},
	{
		"account_digit": "5",
		"account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
		"account_name": "Default",
		"account_number": "26709",
		"amount_limit": 500.0,
		"event_type": "pix_limit_request",
		"limit_type": "self_nightly",
		"owner_document_number": "63602991000100",
		"request_status": "pending_approval",
		"requester_document_number": "53417895200"
	}
]


STATUS
400
Response Body: 发送的数值无效
{
	"title": "Bad Request",
	"description": "Invalid decimal amount, sent 1500.001",
	"translation": "Valor decimal inválido, enviado 1500.001",
	"code": "PXT000043",
	"additional_data": {}
}
STATUS
403
Response Body: 用户没有凭据
{
    "title": "Unauthorized",
    "description": "User is not allowed to do this transaction",
    "translation": "Usuário não tem autorização para fazer essa transação",
    "code": "PIT000001"
}

Webhook Response​

Webhook 触发事件

当限额申请执行时，webhook 将发送给账户申请人

Webhook Request Accepted Body
{
   "webhook_type": "baas.pix.limits.account_limit_config.updated",
   "webhook_datetime": "2023-08-05T19:54:01.514Z",
   "data": {
      "pix_transfer_limit_config": [
         {
            "period": "daily",
            "account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
            "amount_limit": 800012.67,
            "self_amount_limit": 500.03
         },
         {
            "period": "nightly",
            "account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
            "amount_limit": 100000.0,
            "self_amount_limit": 100000.0
         }
      ]
   }
}
Webhook Request Rejected Body
{
   "webhook_type":"baas.pix.limits.account_limit_config.updated",
   "webhook_datetime": "2023-08-05T19:54:01.514Z",
   "data":{
     "message": "QI Tech informa que a solicitacao de limite PIX diário para terceiros da sua conta foi rejeitada. Motivo: limite reanalisado.",
     "account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
     "request_status": "rejected",
     "limit_type": "daily"
   }
}

枚举值 limit_type​

枚举值描述
daily不同账户持有人日间 Pix 转账限额
nightly不同账户持有人夜间 Pix 转账限额
self_daily相同账户持有人日间 Pix 转账限额
self_nightly相同账户持有人夜间 Pix 转账限额