Skip to main content

Create Pix Payment by Pix Key

POST 
/pix/payments/by-key/instant-billing

Initiate a new pix payment using a pix key. First, create a Decoded Pix Key ID at the endpoint /pix/payment/decode/by-key. Then, use the decoded_pix_key_id to enter the pix payment's information in the request body and execute.

Request​

Header Parameters

    x-include-replay-protection-schema string

    The replay-protection-schema allows the user to choose between 3 options:

    • If there's no value: The default protection checks that the values in this request are equal: { method, params, path, query, body, userId }. This means that if a request repeats the same values, it will be blocked.
    • 'nonce': The nonce and { method, params, path, query, body, userId } value are checked. When the protection schema is this, requests will be OK if this nonce value is different in each request.
    • 'x-transaction-uuid': The transactionId and { method, params, path, query, body, userId } value are checked. Requests will be OK if this x-transaction-uuid value is different in each request.
    • 'x-transaction-uuid&nonce' or 'nonce&x-transaction-uuid': The nonce, transactionId value and { method, params, path, query, body, userId } are checked, i.e. if requests are repeated the same value in both fields, they will be blocked. But if any field has a different value, the request is OK.

    x-transaction-uuid stringrequired

    The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.

    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 requisition. All requisitions must have an identifier.

Body

required
    decoded_pix_key_id stringrequired

    Decoded pix key ID.

    value numberrequired

    Value in R$ cents.

    payment_date YYYY-MM-DD

    Payment date.

    description string

    User defined payment description.

Responses​

Payment accomplished.

Schema
    id stringrequired

    Payment UUID.

    operation_id string

    Operation UUID. Used to get receipt and track the transaction. This will not be returned if the payment has been scheduled.

    state stringrequired

    Possible values: [PENDING, WAITING, CONFIRMED, ERROR, FAILED, CANCELED, SCHEDULED]

    Payment state.

    value numberrequired

    Value in R$ cents.

    payment_date date-timenullable

    Schedule a day to execute payment. Use null to send payment right now.

    description stringnullable

    User defined payment description.

    created_at date-timerequired

    Payment created date.

Loading...