---
title: "Issue bank slip"
method: POST
path: "/v1/bankslips-issue"
tags: ["Bank slip issuance"]
---

# Issue bank slip

`POST /v1/bankslips-issue`

Create a bank slip and issue it to the provider. See [Bank slips](https://developers.pismo.io/pismo-docs/docs/bank-slips) for more information.<br>
This endpoint generates the [Bank slip issuance registered](https://developers.pismo.io/events/docs/integrated-payments-bankslip-issue-register-1) event.

## Headers

- `Idempotency-key` string, required

## Request body

- BankslipsIssueIssueRequest
  - `amount` number, required — bank slip amount.
  - `due_date` string, date, required — bank slip payment due date.
  - `debtor` BankslipsIssueIssueDebtor
    - `city` string — City where the debtor resides.
    - `complement` string — Additional address.
    - `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.
    - `name` string — Debtor's full name.
    - `neighborhood` string — Neighborhood name where the debtor resides.
    - `number` string — Street number.
    - `state` string — The name of the state.
    - `street` string — The name of the street where the debtor resides.
    - `zip_code` string — Zip code.
  - `description` string — Description about the bank slip.
  - `instructions` BankslipsIssueIssueInstructions
    - `fine` number, required — Fine to be applied to the bank slip amount if overdue.
    - `interest` number, required — Interest to be applied to the bank slips amount when overdue.
    - `discount` BankslipsIssueIssueDiscount
      - `amount` number — Discounted amount to be applied to the bank slip amount if paid before or on the deadline.
      - `deadline` string — Discount deadline.
      - `type` string — Fixed bank slip type
  - `maximum_amount` number — Maximum amount accepted when paying the bank slip.
  - `minimum_amount` number — Minimum amount accepted when paying the bank slip.
  - `over_due_date` string, date — Last day to accept bank slip payments. After this date, the bank slip is not paid.
  - `pix_key` string — PIX key related to the bank slip.
  - `issuer` string — The name of the provider that issues the bank slip.
  - `transaction_id` string — Transaction ID related to the bank slip issue. This is the ID that links the bank slip to the specific transaction performed in the payments API. It can be used for tracking, reconciliation, and reference purposes when managing bank slips and their associated transactions.

## Response `202`

Accepted

- BankslipsIssueIssueResponse
  - `client_request_id` string — Unique identifier of the request controlled by the client.
  - `external_id` string — Unique identifier of the request controlled by the provider.
  - `status` string — bank slip status. Possible values are `CREATED`, `CANCELLED`, `REGISTERED`, and `ERROR`.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `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)