ChargeDueDateRequestDTO

Request to create a dynamic charge with due date (COBV)

  • calendario
    Type: object · CalendarDueDateRequestDTO
    required

    Calendar settings for charge with due date (COBV)

    • dataDeVencimento
      Type: string Format: date
      required

      Due date for the charge (YYYY-MM-DD). Must be greater than or equal to creation date.

    • validadeAposVencimento
      Type: integer Format: int32
      min:  
      0

      Number of days the charge remains valid after due date. If 0, payment is not allowed after due date. Default is 30 days (Bacen v2.9.0).

    • validAfterDueDaysOrDefault
      Type: integer Format: int32

      Signed 32-bit integers (commonly used integer type).

  • chave
    Type: string
    min length:  
    1
    required

    Pix key of the receiver. EVP, email, CPF/CNPJ or phone in E.164 format (+55...).

  • devedor
    Type: object · DebtorRequestDTO
    required

    Debtor (payer) information

    • nome
      Type: string
      min length:  
      1
      required

      Debtor name

    • cnpj
      Type: string

      Debtor CNPJ (14 digits)

    • cpf
      Type: string

      Debtor CPF (11 digits)

  • locationId
    Type: string Format: uuid
    required

    Location ID to bind to this charge

  • valor
    Type: object · AmountDueDateRequestDTO
    required

    Amount configuration for charge with due date (COBV)

    • original
      Type: string
      min length:  
      1      Pattern: ^\d+\.\d{2}$
      required

      Original amount in decimal format with exactly 2 decimal places

    • abatimento
      Type: object · AbatementDTO

      Abatement configuration for charge with due date

    • desconto
      Type: object · DiscountDTO

      Discount configuration for charge with due date

    • juros
      Type: object · InterestDTO

      Interest configuration for charge with due date

    • multa
      Type: object · FineDTO

      Fine configuration for charge with due date

  • emitImage
    Type: boolean

    If true, returns the PNG image (base64) in the response

  • infoAdicionais
    Type: array object[] · AdditionalInfoDTO[] …50

    Additional information list for the payer

    Additional information for the payer

    • nome
      Type: string
      max length:  
      50
      required

      Name/label of the additional information field.

    • valor
      Type: string
      max length:  
      200
      required

      Value of the additional information field.

  • recebedor
    Type: object · MerchantDataRequestDTO

    Merchant (receiver) information for EMV payload composition

    • cidade
      Type: string
      min length:  
      1
      required

      Merchant city (EMV ID 60).

    • endereco
      Type: object · AddressDTO
      required

      Address information

    • nome
      Type: string
      min length:  
      1
      required

      Merchant name (EMV ID 59).

    • taxId
      Type: string
      min length:  
      1
      required

      Merchant tax ID (CPF/CNPJ).

  • solicitacaoPagador
    Type: string
    max length:  
    140

    Optional message/request for the payer