Valor
A instrução de valor permite alterar o valor de um boleto, desde que o boleto já tenha sido registrado. Caso já exista uma instrução de valor pendente de confirmação para o boleto em questão, não é permitido o envio de uma nova instrução.
Atenção!
Caso exista alguma instrução de valor pendente de confirmação, não é permitido o envio de uma nova instrução.
Request
ENDPOINT
/account/ACCOUNT_KEY/requester_profile/REQUESTER_PROFILE_KEY/bank_slip/BANK_SLIP_KEY/amountMÉTODO
POSTPath parameters
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
account_key | uuidv4 | Chave única de identificação da conta, no formato uuid v4 | 36 |
requester_profile_key | uuidv4 | Chave única de identificação da carteira, no formato uuid v4 | 36 |
bank_slip_key | uuidv4 | Chave única de identificação do boleto, no formato uuid v4 | 36 |
Request Body
{
"request_control_key": "01234567-89ab-cdef-0123-456789abcdef",
"amount": 150.50
}
Request Body Params
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
request_control_key * | uuidv4 | Chave única de identificação da request utilizada pelo cliente no formato uuid v4 | 36 |
amount * | number | Novo valor do boleto (deve ser diferente do valor atual) | - |
Atenção!
O valor deve ser diferente do valor atual do boleto e deve ter no máximo 2 casas decimais.
Response
STATUS
202Response Body
{
"occurrence_key": "5a745b65-9a2c-44eb-b43e-c80ef5429d94",
"bank_slip_key": "fdafdffa-cbd4-4f3c-8e3d-990428305161"
}
Response Body Params
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
occurrence_key * | uuidv4 | Chave única de identificação da ocorrência (instrução) no formato uuid v4 | 36 |
bank_slip_key * | uuidv4 | Chave única de identificação do boleto no formato uuid v4 | 36 |
Error Response
STATUS
4xxResponse Body: Error
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {}
}
Código HTTPstatus | Código QIcode | Títulotitle | Descrição (eng)description | Descrição (pt-br)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 | BKS000032 | Bad Request | Bank slip must be in 'registered' status. | O boleto deve possuir o status 'registered'. |
409 | BKS000135 | Conflict | An amount occurrence already exists for this bank slip. | Já existe uma ocorrência de valor para este boleto. |
400 | BKS000136 | Bad Request | Only credit card financial instrument type can have zero amount. | Apenas o tipo de instrumento financeiro cartão de crédito pode ter valor zero. |
400 | BKS000137 | Bad Request | Amount must be different from bank slip amount. | O valor deve ser diferente do valor do boleto. |