> ## Documentation Index > Fetch the complete documentation index at: https://docs.trio.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Create dynamic QR code with due date > Creates a new dynamic pix QRCode with due date, allowing fine, interest, rebate and discount rules ## OpenAPI ````yaml v2/api-reference/openapi.json POST /v2/in/pix/qrcodes/with_due openapi: 3.0.0 info: title: Trio API v2 version: 2026-10-19.v2 servers: - url: https://api.sandbox.trio.com.br variables: {} - url: https://api.qa.trio.com.br variables: {} - url: https://api.trio.com.br variables: {} security: [] tags: [] paths: /v2/in/pix/qrcodes/with_due: parameters: - description: >- Version of the v2 contract the client is written against. Each breaking change publishes a new version. example: 2026-10-19.v2 in: header name: Trio-Version required: true schema: enum: - 2026-10-19.v2 type: string x-struct: null x-validate: null - description: >- ID of another org to act on instead of the API key's own org. The key's org must have been granted access to it, and the request is refused with 403 FORBIDDEN otherwise. When that access or the API key is read-only, only GET and HEAD requests may carry it. When the target org requires mTLS, so does the request. Leave it out to act on the key's own org. in: header name: Trio-Target-Org-Id required: false schema: format: uuid type: string x-struct: null x-validate: null post: tags: - Receivables (in) - Pix - With Due summary: Create a new dynamic pix QRCode with due date description: >- Creates a new dynamic pix QRCode with due date, allowing fine, interest, rebate and discount rules operationId: TrioFoundationWeb.V2.In.Pix.Qrcode.WithDueController.create parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/V2_DynamicQRCodeWithDueCreateParams' description: Pix QRCode with due date payload required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/V2_DynamicQRCodeWithDueResponse' description: Pix QRCode with due date '400': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- Malformed request: a body that is not valid JSON (MALFORMED_REQUEST), or a Trio-Version header that is missing or not the current one (INVALID_TRIO_VERSION). '401': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: Missing or invalid API key credentials (INVALID_CREDENTIALS). '403': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- The API key may not do this (FORBIDDEN): for instance Trio-Target-Org-Id names an org it has no access to, or writes through a read-only access. '422': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- Invalid input (INVALID_PARAMETER, REQUIRED_PARAMETER, or the code of the rule the request breaks). A request outside the operation's schema lists the offending fields in `errors`. '503': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- A service needed to answer is unavailable (TRIO_SERVICE_UNAVAILABLE). callbacks: {} security: - authorization: [] components: schemas: V2_DynamicQRCodeWithDueCreateParams: description: Body params to create a dynamic QRCode with due date example: amount: 1000 bank_account_id: 41234d60-f6a9-4c9c-8cc3-5769ce9bbea2 counterparty: info: address: Rua Exemplo, 123 city: Curitiba email: counterparty@mail.com postal_code: '80000000' state: PR name: counterparty_name tax_number: '12345678900' description: description due_detail: due_date: '2026-10-27' fine: calculation_type: percentage value: 200 interest: calculation_days: calendar calculation_period: month calculation_type: percentage value: 100 expiration_days: 30 external_id: external_id options: allow_change_the_amount_on_payment: false show_qrcode_image: true properties: amount: description: Amount value of the dynamic QRCode type: integer x-struct: null x-validate: null bank_account_id: description: Bank Account ID type: string x-struct: null x-validate: null counterparty: description: Counterparty (payer) information. Required for QRCodes with due date properties: info: $ref: '#/components/schemas/DynamicQRCodeWithDueCounterpartyInfo' name: description: Counterparty name type: string x-struct: null x-validate: null tax_number: description: Counterparty tax number type: string x-struct: null x-validate: null required: - name - tax_number type: object x-struct: null x-validate: null description: description: Description of the dynamic QRCode type: string x-struct: null x-validate: null due_detail: $ref: '#/components/schemas/V2_PixDueDetailParams' expiration_days: description: >- Number of days after the due date during which the QRCode can still be paid. Defaults to 1 minimum: 0 nullable: true type: integer x-struct: null x-validate: null external_id: description: External ID of the dynamic QRCode type: string x-struct: null x-validate: null merchant: description: >- Merchant to register as the split org merchant. When sent, it is saved. nullable: true properties: name: description: Merchant name type: string x-struct: null x-validate: null tax_number: description: Merchant tax number type: string x-struct: null x-validate: null required: - name - tax_number type: object x-struct: null x-validate: null options: description: QRCode creation options properties: allow_change_the_amount_on_payment: description: Allow amount change type: boolean x-struct: null x-validate: null show_qrcode_image: description: Show qrcode image type: boolean x-struct: null x-validate: null required: - allow_change_the_amount_on_payment - show_qrcode_image type: object x-struct: null x-validate: null platform_id: description: Platform ID of the dynamic QRCode nullable: true type: string x-struct: null x-validate: null splits: description: Cashin split configurations items: properties: counterparty_recipient_id: description: Counterparty recipient UUID type: string x-struct: null x-validate: null type: description: Split type enum: - percentage - fixed type: string x-struct: null x-validate: null value: description: Percentage (0-100) or fixed amount in cents type: integer x-struct: null x-validate: null required: - type - value - counterparty_recipient_id type: object x-struct: null x-validate: null nullable: true type: array x-struct: null x-validate: null required: - amount - counterparty - due_detail - options - bank_account_id title: V2 DynamicQRCodeWithDueCreateParams type: object x-struct: >- Elixir.TrioFoundationWeb.Schemas.Banking.V2.Cashin.DynamicBrcodeWithDue.CreateParams x-validate: null V2_DynamicQRCodeWithDueResponse: description: Response schema for a single dynamic QRCode with due date example: data: amount: amount: 1000 currency: BRL bank_account_id: 01a0d98d-7547-22cf-f4f6-e8a63cd72cf5 counterparty: id: 41234d60-f6a9-4c9c-8cc3-5769ce9bbea2 description: description due_detail: due_date: '2026-09-30' fine: calculation_type: percentage value: 200 expiration_datetime: '2026-10-06T02:59:59.999999Z' external_id: external_id fee: amount: 0 currency: BRL hash: >- 00020101021226640014br.gov.bcb.pix2542qrcode.trio.com.br/cobv/01M3CRTXYFDDFTA8MF4XH2183B5204000053039865802BR5909NAME TEST6009NAME TEST62070503***63042C42 id: 01a0d98d-77cf-6b5f-a522-8f276220a06b inserted_at: '2026-09-25T17:12:02.255000Z' options: allow_change_the_amount_on_payment: true origin: id: 41234d60-f6a9-4c9c-8cc3-5769ce9bbea2 type: none status: created updated_at: '2026-09-25T17:12:02.255000Z' properties: data: $ref: '#/components/schemas/V2_DynamicQRCodeWithDueData' title: V2 DynamicQRCodeWithDueResponse type: object x-struct: >- Elixir.TrioFoundationWeb.Schemas.Banking.V2.Cashin.DynamicBrcodeWithDue.Response x-validate: null V2_error: example: error: error_code: INVALID_PARAMETER error_message: 'Invalid parameters: /amount: Invalid integer. Got: string' errors: - field: /amount message: 'Invalid integer. Got: string' properties: error: properties: error_code: description: >- Stable UPPER_SNAKE identifier of the error, for programs and logs. Branch on this, not on the message. type: string x-struct: null x-validate: null error_message: description: Human readable explanation of the error. type: string x-struct: null x-validate: null errors: description: >- Only on INVALID_PARAMETER for a request outside the operation's schema: one entry per offending field. items: properties: field: description: JSON pointer to the field, e.g. /amount. type: string x-struct: null x-validate: null message: description: What is wrong with it. type: string x-struct: null x-validate: null required: - field - message type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - error_code - error_message type: object x-struct: null x-validate: null required: - error title: V2 error type: object x-struct: Elixir.TrioFoundationWeb.Schemas.HTTP.V2Error x-validate: null DynamicQRCodeWithDueCounterpartyInfo: description: Additional counterparty information printed on the QRCode with due date nullable: true properties: address: description: Counterparty address nullable: true type: string x-struct: null x-validate: null city: description: Counterparty city nullable: true type: string x-struct: null x-validate: null email: description: Counterparty email nullable: true type: string x-struct: null x-validate: null postal_code: description: Counterparty postal code nullable: true type: string x-struct: null x-validate: null state: description: Counterparty state (UF) nullable: true type: string x-struct: null x-validate: null title: DynamicQRCodeWithDueCounterpartyInfo type: object x-struct: >- Elixir.TrioFoundationWeb.Schemas.Banking.V1.Cashin.DynamicBrcodeWithDue.CounterpartyInfo x-validate: null V2_PixDueDetailParams: description: >- Due detail of a Pix charge with due date. Each rule takes `amount` (cents) for the `amount` calculation type and `value` (basis points, 100 = 1%) for `percentage`. example: discount: per_day_antecipated: amount: 50 calculation_days: working calculation_type: amount due_date: '2026-09-30' fine: calculation_type: percentage value: 200 interest: calculation_days: calendar calculation_period: month calculation_type: percentage value: 100 properties: discount: description: Discount for payments before the due date; set only one option properties: fixed_until_due: description: Discount granted until each date properties: amounts: items: properties: amount: description: Amount in cents, for the `amount` calculation type minimum: 1 type: integer x-struct: null x-validate: null date: description: Last date on which the discount applies format: date type: string x-struct: null x-validate: null value: description: >- Percentage in basis points (100 = 1%), for the `percentage` calculation type minimum: 1 type: integer x-struct: null x-validate: null required: - date type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null calculation_type: $ref: >- #/components/schemas/DynamicBrcodeDueDetailDiscountCalculationType required: - calculation_type - amounts type: object x-struct: null x-validate: null per_day_antecipated: description: Discount per day paid in advance properties: amount: description: Amount in cents, for the `amount` calculation type minimum: 1 type: integer x-struct: null x-validate: null calculation_days: $ref: >- #/components/schemas/DynamicBrcodeDueDetailDiscountCalculationDays calculation_type: $ref: >- #/components/schemas/DynamicBrcodeDueDetailDiscountCalculationType value: description: >- Percentage in basis points (100 = 1%), for the `percentage` calculation type minimum: 1 type: integer x-struct: null x-validate: null required: - calculation_type type: object x-struct: null x-validate: null type: object x-struct: null x-validate: null due_date: description: Due date format: date type: string x-struct: null x-validate: null fine: description: Fine charged after the due date properties: amount: description: Amount in cents, for the `amount` calculation type minimum: 1 type: integer x-struct: null x-validate: null calculation_type: $ref: '#/components/schemas/DynamicBrcodeDueDetailFineCalculationType' value: description: >- Percentage in basis points (100 = 1%), for the `percentage` calculation type minimum: 1 type: integer x-struct: null x-validate: null required: - calculation_type type: object x-struct: null x-validate: null interest: description: Interest charged after the due date properties: amount: description: Amount in cents, for the `amount` calculation type minimum: 1 type: integer x-struct: null x-validate: null calculation_days: $ref: >- #/components/schemas/DynamicBrcodeDueDetailInterestCalculationDays calculation_period: $ref: >- #/components/schemas/DynamicBrcodeDueDetailInterestCalculationPeriod calculation_type: $ref: >- #/components/schemas/DynamicBrcodeDueDetailInterestCalculationType value: description: >- Percentage in basis points (100 = 1%), for the `percentage` calculation type minimum: 1 type: integer x-struct: null x-validate: null required: - calculation_type type: object x-struct: null x-validate: null rebate: description: Rebate applied to the amount properties: amount: description: Amount in cents, for the `amount` calculation type minimum: 1 type: integer x-struct: null x-validate: null calculation_type: $ref: '#/components/schemas/DynamicBrcodeDueDetailRebateCalculationType' value: description: >- Percentage in basis points (100 = 1%), for the `percentage` calculation type minimum: 1 type: integer x-struct: null x-validate: null required: - calculation_type type: object x-struct: null x-validate: null required: - due_date title: V2 PixDueDetailParams type: object x-struct: null x-validate: null V2_DynamicQRCodeWithDueData: description: >- A dynamic QRCode with due date, as returned by show and create. `image` is present only when create was asked for it with `options.show_qrcode_image`. example: amount: amount: 1000 currency: BRL bank_account_id: 01a0d98d-7547-22cf-f4f6-e8a63cd72cf5 counterparty: id: 41234d60-f6a9-4c9c-8cc3-5769ce9bbea2 description: description due_detail: due_date: '2026-09-30' fine: calculation_type: percentage value: 200 expiration_datetime: '2026-10-06T02:59:59.999999Z' external_id: external_id fee: amount: 0 currency: BRL hash: >- 00020101021226640014br.gov.bcb.pix2542qrcode.trio.com.br/cobv/01M3CRTXYFDDFTA8MF4XH2183B5204000053039865802BR5909NAME TEST6009NAME TEST62070503***63042C42 id: 01a0d98d-77cf-6b5f-a522-8f276220a06b inserted_at: '2026-09-25T17:12:02.255000Z' options: allow_change_the_amount_on_payment: true origin: id: 41234d60-f6a9-4c9c-8cc3-5769ce9bbea2 type: none status: created updated_at: '2026-09-25T17:12:02.255000Z' properties: amount: description: Amount value of the dynamic QRCode properties: amount: description: Amount integer type: integer x-struct: null x-validate: null currency: description: Amount currency string type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null bank_account_id: description: Bank account that receives the payment format: uuid type: string x-struct: null x-validate: null counterparty: description: Payer the QRCode is issued to properties: id: description: Counterparty ID format: uuid nullable: true type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null description: description: Description of the dynamic QRCode type: string x-struct: null x-validate: null due_detail: $ref: '#/components/schemas/V2_PixDueDetail' expiration_datetime: description: Datetime after which the QRCode can no longer be paid format: date-time type: string x-struct: null x-validate: null external_id: description: External ID of the dynamic QRCode nullable: true type: string x-struct: null x-validate: null fee: description: Fee charged on the payment nullable: true properties: amount: description: Fee in cents type: integer x-struct: null x-validate: null currency: description: Currency type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null hash: description: Hash (Pix copy and paste) of the QRCode type: string x-struct: null x-validate: null id: description: Unique identifier format: uuid type: string x-struct: null x-validate: null image: description: Base64 QRCode image, only when requested on create type: string x-struct: null x-validate: null inserted_at: description: When the QRCode was created format: date-time type: string x-struct: null x-validate: null options: description: Payment options of the QRCode properties: allow_change_the_amount_on_payment: description: Whether the payer may change the amount type: boolean x-struct: null x-validate: null type: object x-struct: null x-validate: null origin: description: Who or what created the QRCode properties: id: description: Origin ID format: uuid nullable: true type: string x-struct: null x-validate: null type: description: Origin type nullable: true type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null status: description: Status of the dynamic QRCode enum: - created - settled - deleted type: string x-struct: null x-validate: null updated_at: description: When the QRCode was last updated format: date-time type: string x-struct: null x-validate: null title: V2 DynamicQRCodeWithDueData type: object x-struct: >- Elixir.TrioFoundationWeb.Schemas.Banking.V2.Cashin.DynamicBrcodeWithDue.QrCodeData x-validate: null DynamicBrcodeDueDetailDiscountCalculationType: description: Discount calculation type of dynamic brcode with due detail enum: - amount - percentage nullable: true title: DynamicBrcodeDueDetailDiscountCalculationType type: string x-struct: null x-validate: null DynamicBrcodeDueDetailDiscountCalculationDays: description: Discount calculation days of dynamic brcode with due detail enum: - calendar - working nullable: true title: DynamicBrcodeDueDetailDiscountCalculationDays type: string x-struct: null x-validate: null DynamicBrcodeDueDetailFineCalculationType: description: Fine calculation type of dynamic brcode with due detail enum: - amount - percentage nullable: true title: DynamicBrcodeDueDetailFineCalculationType type: string x-struct: null x-validate: null DynamicBrcodeDueDetailInterestCalculationDays: description: Interest calculation days of dynamic brcode with due detail enum: - calendar - working nullable: true title: DynamicBrcodeDueDetailInterestCalculationDays type: string x-struct: null x-validate: null DynamicBrcodeDueDetailInterestCalculationPeriod: description: Interest calculation period of dynamic brcode with due detail enum: - day - month - year nullable: true title: DynamicBrcodeDueDetailInterestCalculationPeriod type: string x-struct: null x-validate: null DynamicBrcodeDueDetailInterestCalculationType: description: Interest calculation type of dynamic brcode with due detail enum: - amount - percentage nullable: true title: DynamicBrcodeDueDetailInterestCalculationType type: string x-struct: null x-validate: null DynamicBrcodeDueDetailRebateCalculationType: description: Rebate calculation type of dynamic brcode with due detail enum: - amount - percentage nullable: true title: DynamicBrcodeDueDetailRebateCalculationType type: string x-struct: null x-validate: null V2_PixDueDetail: description: >- Due detail of a Pix charge with due date. `due_date` is always present; each rule only when set. A rule has `amount` (money) for the `amount` calculation type and `value` (basis points, 100 = 1%) for `percentage`. example: discount: per_day_antecipated: amount: amount: 50 currency: BRL calculation_days: working calculation_type: amount due_date: '2026-09-30' fine: calculation_type: percentage value: 200 interest: calculation_days: calendar calculation_period: month calculation_type: percentage value: 100 properties: discount: description: Discount for payments before the due date; only one option is set properties: fixed_until_due: description: Discount granted until each date properties: amounts: items: properties: amount: description: Amount, for the `amount` calculation type properties: amount: description: Amount in cents type: integer x-struct: null x-validate: null currency: description: Currency type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null date: description: Last date on which the discount applies format: date type: string x-struct: null x-validate: null value: description: >- Percentage in basis points (100 = 1%), for the `percentage` calculation type type: integer x-struct: null x-validate: null type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null calculation_type: $ref: >- #/components/schemas/DynamicBrcodeDueDetailDiscountCalculationType type: object x-struct: null x-validate: null per_day_antecipated: description: Discount per day paid in advance properties: amount: description: Amount, for the `amount` calculation type properties: amount: description: Amount in cents type: integer x-struct: null x-validate: null currency: description: Currency type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null calculation_days: $ref: >- #/components/schemas/DynamicBrcodeDueDetailDiscountCalculationDays calculation_type: $ref: >- #/components/schemas/DynamicBrcodeDueDetailDiscountCalculationType value: description: >- Percentage in basis points (100 = 1%), for the `percentage` calculation type type: integer x-struct: null x-validate: null type: object x-struct: null x-validate: null type: object x-struct: null x-validate: null due_date: description: Due date format: date type: string x-struct: null x-validate: null fine: description: Fine charged after the due date properties: amount: description: Amount, for the `amount` calculation type properties: amount: description: Amount in cents type: integer x-struct: null x-validate: null currency: description: Currency type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null calculation_type: $ref: '#/components/schemas/DynamicBrcodeDueDetailFineCalculationType' value: description: >- Percentage in basis points (100 = 1%), for the `percentage` calculation type type: integer x-struct: null x-validate: null type: object x-struct: null x-validate: null interest: description: Interest charged after the due date properties: amount: description: Amount, for the `amount` calculation type properties: amount: description: Amount in cents type: integer x-struct: null x-validate: null currency: description: Currency type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null calculation_days: $ref: >- #/components/schemas/DynamicBrcodeDueDetailInterestCalculationDays calculation_period: $ref: >- #/components/schemas/DynamicBrcodeDueDetailInterestCalculationPeriod calculation_type: $ref: >- #/components/schemas/DynamicBrcodeDueDetailInterestCalculationType value: description: >- Percentage in basis points (100 = 1%), for the `percentage` calculation type type: integer x-struct: null x-validate: null type: object x-struct: null x-validate: null rebate: description: Rebate applied to the amount properties: amount: description: Amount, for the `amount` calculation type properties: amount: description: Amount in cents type: integer x-struct: null x-validate: null currency: description: Currency type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null calculation_type: $ref: '#/components/schemas/DynamicBrcodeDueDetailRebateCalculationType' value: description: >- Percentage in basis points (100 = 1%), for the `percentage` calculation type type: integer x-struct: null x-validate: null type: object x-struct: null x-validate: null required: - due_date title: V2 PixDueDetail type: object x-struct: null x-validate: null securitySchemes: authorization: scheme: basic type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.