---
title: "Create a bank slip with pix"
method: POST
path: "/v2/transactions/{transaction_id}/bank-slip"
tags: ["Transactions"]
---

# Create a bank slip with pix

`POST /v2/transactions/{transaction_id}/bank-slip`

## Request

- Base URL: `https://api.edubank.com.br` (the document declares no server; this is the origin it was published from)
- URL: `https://api.edubank.com.br/v2/transactions/{transaction_id}/bank-slip`
- Auth: one of:
  - API key in header `authorization`
  - API key in header `x-api-key`
  - API key in header `authorization`
- TypeScript: <https://skmtc.dev/edubank/apis/api-edubank/docs/v2/transactions/:transaction_id/bank-slip/post.ts> (a function with typed inputs; its response is checked against the schema)

This version allows you to create a Bank Slip with Pix. The new PDF layout includes the Pix code

bank_slip_link is set to HTML by default

#### Limitations
- Only 2 discounts will be included, even if the transaction has more

## Path parameters

- `transaction_id` string, required

## Request body

- EdubankTransactionBankSlipPixCreate
  - `bank_slip_link` 'PDF' | 'HTML': Indicates whether the PDF of the bank slip or the HTML should be returned

## Response `201`

The object has been successfully created

- EdubankTransactionSuccessResponseBankSlip
  - `status_code` number, required: Status code
  - `transaction_id` string, required: Edubank transaction id
  - `transaction_type` string, required: Type of transaction performed. CARD/PIX/BANK_SLIP/BANK_SLIP_PIX
  - `status` string, required: Current transaction status
  - `payment_id` string, required: Payment id
  - `bank_slip_link` string: URL for payment slip
  - `bank_slip_barcode` string: Barcode for payment slip
  - `bank_slip_digitable_line` string: Digitable line for payment slip
  - `bank_slip_document_number` string: "Our number" from the bank slip
  - `pix_qrcode` string: Pix qrcode
  - `pix_base64` string: Pix qrcode image in base64
  - `pix_expiration` string: Pix expiration

## Other responses

- `400`: Client specified an invalid argument, request body or query param
- `401`: The user is unauthorized
- `403`: Authenticated user is not allowed to access this resource
- `404`: The resource was not found
- `408`: Request timeout
- `422`: Error: Unprocessable Entity
- `429`: Too many requests
- `500`: Internal server error

---

[API](https://skmtc.dev/edubank/apis/api-edubank.md) - [All operations](https://skmtc.dev/edubank/apis/api-edubank/llms.txt) - [OpenAPI document](https://skmtc.dev/edubank/apis/api-edubank/revisions/dce4008191d4?raw)
