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

# Validate bank slip

`POST /v1/bankslips/validate`

Validate bank slip with provider partner.<br>
You need to call this endpoint before calling [Pay bank slip](https://developers.pismo.io/pismo-docs/reference/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](https://developers.pismo.io/pismo-docs/reference/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.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)