取消折让

取消折让意味着取消 Boleto 的现有折让。若有意移除折让或创建新折让，则需进行取消操作。

注意！

若存在待确认的折让取消申请，或不存在活跃的折让，则无法申请取消折让。

注意： 在 Boleto 登记时发送的折让金额（rebate_amount）（若大于 R$0,00）视为活跃折让。

Request

ENDPOINT

/account/ACCOUNT_KEY/requester_profile/REQUESTER_PROFILE_KEY/bank_slip/BANK_SLIP_KEY/cancel_rebate

MÉTODO

POST

路径参数

字段	类型	描述	字符数
account_key	uuidv4	账户唯一识别密钥，格式为 uuid v4	36
requester_profile_key	uuidv4	钱包唯一识别密钥，格式为 uuid v4	36
bank_slip_key	uuidv4	Boleto 唯一识别密钥，格式为 uuid v4	36

Request Body

{
  "request_control_key": "86864aec-a6c8-462e-8460-b05ef5a1eb62"
}

Request Body Params

字段	类型	描述	字符数
request_control_key *	uuidv4	客户使用的请求唯一识别密钥，格式为 uuid v4	36

Response

STATUS

202

Response Body

{
  "occurrence_key": "539cefc8-382e-4fef-80e1-978a3a178a5c",
  "bank_slip_key": "d402e91a-32ac-4428-8357-d71824b113b5"
}

Response Body Params

字段	类型	描述	字符数
occurrence_key *	uuidv4	事件（指令）唯一识别密钥，格式为 uuid v4	36
bank_slip_key *	uuidv4	Boleto 唯一识别密钥，格式为 uuid v4	36

错误响应

STATUS

4xx

Response Body: 错误

{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo",
  "extra_fields": {}
}

HTTP 代码 status	QI 代码 code	标题 title	英文描述 description	葡语描述 translation
400	QIT000001	Bad Request	Schema Error	Schema Inválido
404	BKS000006	Not Found	The source account key was not found.	A chave da conta de origem não foi encontrada.
400	BKS000007	Bad Request	It was not possible to consult the source account at this time. Please try again in a few minutes.	Não foi possível consultar a conta de origem neste momento. Por favor, tente novamente em alguns minutos.
400	BKS000008	Bad Request	The source account is closed.	A conta de origem está fechada.
400	BKS000009	Bad Request	The source account is blocked.	A conta de origem está bloqueada.
404	BKS000013	Not Found	Requester profile not found	Carteira não encontrada
409	BKS000014	Conflict	Request control key already sent or duplicated sent: <request_control_key>	Chave de controle da requisição já utilizada ou enviada duplicada: <request_control_key>
400	BKS000022	Bad Request	Requester profile is not opened.	Carteira não está aberta.
404	BKS000029	Not Found	Bank slip not found for the given key ({bank_slip_key}).	Boleto não encontrado para a chave fornecida ({bank_slip_key}).
400	BKS000031	Bad Request	Bank slip must have an active rebate.	O boleto deve possuir um rebate ativo.
400	BKS000032	Bad Request	Bank slip must be in 'registered' status.	O boleto deve possuir o status 'registered'.
409	BKS000034	Bad Request	There is already a pending cancel rebate occurrence for this bank slip.	Já existe uma ocorrência de cancelamento de rebate pendente para este boleto.