---
title: "Validação do título"
method: POST
path: "/bill-payment/validate"
tags: ["Pagamento de contas"]
---

# Validação do título

`POST /bill-payment/validate`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/bill-payment/validate`
- Auth: none declared

<div class="bkly-ref-description">
  <p>Realize a validação por meio da linha digitável para verificar se o título está apto a ser pago.</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: payment.validate</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Validação do título](/docs/validacao-do-pagamento)."
}
[/block]

## Parameters

- `#/paths/~1bill-payment/get/parameters/0` (unresolved $ref)
- `#/paths/~1bill-payment/get/parameters/1` (unresolved $ref)
- `#/paths/~1bill-payment/get/parameters/2` (unresolved $ref)

## Request body

- ValidateBillRequest
  - `code` string, nullable, required: Linha digitável.

## Response `200`

A linha digitável foi validada.

- ValidateBillResponse
  - `id` string, uuid: Identificador único que será necessário no momento de confirmar o pagamento.
  - `assignor` string, nullable: Nome do cedente.
  - `recipient` BillRecipientPerson: Objeto que contém informações sobre o recebedor do pagamento.
    - `name` string, nullable: Nome do recebedor.
    - `documentNumber` string, nullable: Número do documento do recebedor.
  - `payer` BillPayerPerson: Objeto que contém informações sobre o cedente.
    - `name` string, nullable: Nome do cedente.
    - `documentNumber` string, nullable: Número do documento do cedente.
  - `businessHours` BillBusinessHours: Objeto que contém informações sobre a faixa de horário permitida para pagamento.
    - `start` string, nullable: Horário mínimo para realizar o pagamento.
    - `end` string, nullable: Horário máximo para realizar o pagamento.
  - `dueDate` string, date-time: Data de vencimento do título.
  - `settleDate` string, date-time, nullable: Data em que o pagamento será liquidado.
  - `nextSettle` boolean: Informa se o título será liquidado no próximo dia útil.
  - `originalAmount` number, double, nullable: Valor original, sem encargos.
  - `amount` number, double, nullable: Valor a ser pago.
  - `charges` BillCharges: Objeto que contém informações sobre os encargos aplicados na transação. Em caso de pagamentos desfeitos, esse objeto retornará seus campos com valores <b>nulos</b>.
    - `interestAmountCalculated` number, double: Valor dos juros.
    - `fineAmountCalculated` number, double: Valor da multa.
    - `discountAmount` number, double: Valor do desconto.
  - `maxAmount` number, double: Máximo valor permitido por pagamento.
  - `minAmount` number, double: Mínimo valor permitido por pagamento.
  - `allowChangeAmount` boolean: Indica se é permitido pagamento parcial.
  - `digitable` string, nullable: Linha digitável.

## Other responses

- `400` (unresolved $ref)
- `429` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/pagamento-de-contas.md) - [All operations](https://skmtc.dev/bankly/apis/pagamento-de-contas/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/pagamento-de-contas/revisions/880c2bac4ff1?raw)