Skip to main content

Create an Automatic Pix Recurrence

POST 
/v1/pix/scheduled-payments/automatic-recurrences
Tag: api-baas-create-pix-automatic-recurrenceDescription: Creates an automatic pix recurrence to be able to send payment schedules to the payer/debtor.

Request​

Header Parameters

    x-wallet-uuid string

    Sender Wallet UUID (if empty, your default Wallet UUID will be settled)

    nonce stringrequired

    The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

    x-lang string

    Possible values: [pt-BR, en-US]

    Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

    x-product-uuid string

    The product ID is a UUID (v4) used to identify the Z.ro product configuration.

    x-product-target-user-uuid string

    The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.

Body

required
    journey stringrequired

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

    Automatic pix journey. JOURNEY_1: An automatic pix recurrence will be created and a notification to the payer will be sent. JOURNEY_4: A 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.

    floor_max_value number

    Maximum floor value.

    owner_ispb stringrequired

    Possible values: non-empty and <= 8 characters

    Owner (payer) Bank ISPB

    owner_name string

    Owner (payer) name (required if journey 4)

    owner_document stringrequired

    Owner (payer) document (CPF or CNPJ)

    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 4)

    debtor_name string

    Debtor name (required if journey 4)

    contract_number stringrequired

    Contract number or reference code

    contract_description stringrequired

    Contract description

    tags string[]required

    Tags (max: 5)

    request_expiration_date date-time

    Expiration date (required if journey 1)

    pix_key_id string

    Pix key ID (required if journey 4)

    charge_value number

    Charge value (required if journey 4)

    charge_due_date date-time

    Charge due date (required if journey 4)

Responses​

Recurrence successfully created.

Schema
    id stringrequired

    Recurrence ID.

    status stringrequired

    Possible values: [PENDING, CREATED, FAILED, APPROVED, REJECTED, CANCELED, EXPIRED, FINISHED]

    Recurrence status

    state stringrequired

    Possible values: [PENDING_CONFIRMED, CREATED_CONFIRMED, CREATED_FAILED, APPROVED_CONFIRMED, REJECTED_CONFIRMED, CANCELED_CONFIRMED, CANCELED_FAILED, EXPIRED_CONFIRMED, FINISHED_CONFIRMED]

    Recurrence status

Loading...