Skip to main content

CreatePixAutomaticRecurrenceBodyParam

    journey stringrequired

    Possible values: [JOURNEY_1, JOURNEY_2, JOURNEY_3, JOURNEY_4, JOURNEY_4_STATIC]

    Automatic pix journey. JOURNEY_1: An automatic pix recurrence will be created and a notification to the payer will be sent. JOURNEY_2: A composite QRCode will be generated to be shared with the payer to approve the automatic pix recurrence. JOURNEY_3: A composite dynamic QRCode will be generated to be shared with the payer to approve the automatic pix recurrence and pay an immediate charge. JOURNEY_4: A composite dynamic QRCode will be generated to be shared with the payer to pay or schedule the payment of the charge and approve (optional) the automatic pix recurrence. JOURNEY_4_STATIC: A composite static QRCode will be generated to be shared with the payer to pay or schedule the payment of the charge and approve (optional) the automatic pix recurrence.

    frequency stringrequired

    Possible values: [WEEKLY, MONTHLY, QUARTERLY, SEMI_ANNUALLY, ANNUALLY]

    Frequency.

    start_date date-timerequired

    Date of the first payment of the automatic pix recurrence.

    end_date date-time

    Date for when the automatic pix recurrence will be ended.

    value number

    Recurrence fixed value for the charges in Brazilian Real (R$) cents.

    floor_max_value number

    Maximum floor value in Brazilian Real (R$) cents. Must not be provided if (fixed) value is provided.

    owner_ispb string

    Possible values: non-empty and <= 8 characters

    Owner (payer) Bank ISPB (required for all journeys except journey 4 static).

    owner_name string

    Owner (payer) name (required if journey 3 or 4 (dynamic)).

    owner_document string

    Owner (payer) document (CPF or CNPJ) (required for all journeys except journey 4 static).

    owner_bank_branch string

    Possible values: non-empty and <= 5 characters

    Owner (payer) Bank branch (required if journey 1).

    owner_bank_account string

    Owner (payer) Bank account number (required if journey 1).

    debtor_document stringrequired

    Debtor document (CPF or CNPJ) (required if journey 2, 3 or 4 dynamic).

    debtor_name string

    Debtor name (required if journey 2, 3 or 4 dynamic).

    contract_number stringrequired

    Contract number or reference code.

    contract_description string

    Contract description.

    tags string[]

    Tags (max: 5).

    request_expiration_date date-time

    Expiration date (required if journey 1).

    pix_key_id string

    Pix key ID (required if journey 3 or 4 (dynamic and static)).

    charge_value number

    Charge value (required if journey 3 or 4 dynamic (also available for journey 4 static)).

    charge_due_date date-time

    Charge due date (required if journey 4 dynamic).

    interest_perc_value number

    Interest value specified in percentage by month. Available only for journey 4 dynamic.

    fine_value number

    Fine value (in (R$) amount or percentage). Available only for journey 4 dynamic.

    fine_type string

    Possible values: [AMOUNT, PERCENTAGE]

    Fine type. Available only for journey 4 dynamic.

    discount_value number

    Discount value (in (R$) amount or percentage). Available only for journey 4 dynamic.

    discount_type string

    Possible values: [AMOUNT, PERCENTAGE]

    Discount type. Available only for journey 4 dynamic.