---
title: "Validate bank slip"
method: POST
path: "/v1/bankslips/validate"
tags: ["Bank slip"]
---

# Validate bank slip

`POST /v1/bankslips/validate`

## Request

- Base URL: `https://sandbox.pismolabs.io/integrated-payments`
- URL: `https://sandbox.pismolabs.io/integrated-payments/v1/bankslips/validate`
- Auth: HTTP bearer

Validate bank slip with provider partner.<br>
You need to call this endpoint before calling [Pay bank slip](ref:post-integrated-payments-api-v1-bankslips-pay). If this endpoint returns an `external_authorization` field value, you must pass it in the Pay bank slip call.<br>
For this endpoint, either `bar_code` or `digitable_line` **must** be passed.

## Headers

- `Authorization` string, required

## Request body

- BankslipsBankslipsValidateRequest
  - `type` 1 | 2, required: Banslip type. (`1` = compensation form, `2` = dealership)<br> Compensation form refers to the method for processing the bank slip. Dealership (cedente) refers to the entity or individual that issues the bank slip.
  - `bar_code` string: Bar code encoding bank slip information such as the bank code, currency code, check digit, due date, amount, and beneficiary information.
  - `digitable_line` string: Digitable line. On a Brazilian bank slip, the digitable line contains numerical payment information encoding details like the payment amount, due date, beneficiary information, and other transaction-specific data.

## Response `200`

Response Body

- BankslipsBankslipsValidateResponse
  - `amount` number: Amount to pay.
  - `assignor` string: The name of the receiver bank.
  - `bar_code` string: Bar code.
  - `beneficiary_document_number` string: A government document number, such as a CPF (Brazil) - Cadastro de Pessoas Fisicas (Indiviual Taxpayer Registry) number, CNPJ (Brazil) - Cadastro Nacional de Pessoa Juridica (National Registry of Legal Entities) number - unique ID for legal entities, such as companies and organizations.
  - `beneficiary_name` string: Beneficiary name.
  - `digitable_line` string: Digitable line. On a Brazilian bank slip, the digitable line contains numerical payment information encoding details like the payment amount, due date, beneficiary information, and other transaction-specific data.
  - `discount_value` number: Discount value.
  - `due_date` string, datetime: Due datetime. ISO 8601 format - `yyyy-MM-ddTHH:mm:ss.SSSSSSSSSZ`.
  - `external_authorization` string: Some providers return this to a [Validate bank slip](ref:post-integrated-payments-api-v1-bankslips-validate) call. If returned, you must pass it in a Pay bank slip](ref:post-integrated-payments-api-v1-bankslips-pay) endpoint call. If returned, this value must be passed on to a bank slip payment request.
  - `fine_value` number: Fine value.
  - `interest_value` number: Interest value.
  - `limit_date` string, date: Limit datetime to pay. ISO 8601 format - `yyyy-MM-ddTHH:mm:ss.SSSSSSSSSZ`.
  - `max_value` number: Maximum value.
  - `min_value` number: Minimum value.
  - `original_value` number: Original value.
  - `payer_document_number` string: A government document number, such as a CPF (Brazil) - Cadastro de Pessoas Fisicas (Indiviual Taxpayer Registry) number, CNPJ (Brazil) - Cadastro Nacional de Pessoa Juridica (National Registry of Legal Entities) number - unique ID for legal entities, such as companies and organizations.
  - `payer_name` string: Payer's name.
  - `settle_date` string, date: Settlement date. ISO 8601 format - `yyyy-MM-ddTHH:mm:ss.SSSSSSSSSZ`.
  - `type` integer: bank slip type. (`1` = compensation form, `2` = dealership).<br> Compensation form refers to the method for processing the bank slip. Dealership (cedente) refers to the entity or individual that issues the bank slip.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error
- `502`: Bad Gateway

---

[API](https://skmtc.dev/pismo/apis/banking-integrated-payments.md) - [All operations](https://skmtc.dev/pismo/apis/banking-integrated-payments/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/banking-integrated-payments/revisions/a578004b933a?raw)