Pix-out notification received

Event generated when the Pix-out transfer endpoint is called. For more information, see the Pix-instant payments guide. Also see the Pix payments data events guide.

Type: object
Domain: pix
Event: pix_out
Version: 1

|
account_id required

Title: Account ID
Description: Pismo account ID
Type: integer
Example:
123

amount required

Title: Pix-out amount
Description: Pix-out amount
Type: number
Format: double
Example:
125.5

authorization_datetime required

Title: Authorization datetime
Description: Authorization date/time from the Pismo platform. A RFC 3339 date-time value, i.e., '2023-04-12T23:20:50.52Z'.
Type: string
Format: date-time
Example:
2021-10-29T11:00:00.000Z

authorization_id required

Title: Authorization ID
Description: Pismo authorization ID
Type: integer
Example:
123

client_request_id required

Title: Unique transaction ID
Description: Client-generated unique transaction ID. This value cannot be repeated.
Type: string
Max length: 36
Example:
bc0bc832-ca05-425e-95d4-a1bf48ada1cc

end_to_end_id required

Title: Pix end to end ID
Description: Pix end to end transaction ID. This field is a Brazil Central Bank (BCB) requirement to track Pix transactions. Basically, there are two steps to a Pix transaction: 1. Initialize a transaction and 2. Confirm a transaction. This field is sent to the BCB in both steps in order to identify all transaction information.
Type: string
Example:
E0000000020210519134701363533333

initiation_type required

Title: Payment initiation type
Description: Initiated payment type: MANUAL - Manually initiated. Key is not used - bank account, bank code, document number, and branch is used for identification. DICT - Diretorio de Identificadores de Contas de Transacapo (Transaction accounts identifier directory). Pix/DICT key is used for identification. STATIC_QRCODE - Reusable code that contains only the data necessary to complete a transaction. When using static QR code, the transaction amount must be provided manually. DYNAMIC_QRCODE - The amount and other details for a dynamic code are included automatically. PAYMENT_INITIATOR - Payment provider initiated. A payment initiator is a 3rd party that has obtained authorization from the Central Bank and has an Open Finance certification.
Type: string
Max length: 50
Must be one of the following:
MANUAL
DICT
STATIC_QRCODE
DYNAMIC_QRCODE
PAYMENT_INITIATOR
Example:
PAYMENT_INITIATOR

payee required

Type: object

account_number required

Title: Account Number
Description: Payee account number
Type: string
Max length: 10
Example:
98765432

bank required

Title: Bank
Description: Payee's bank code - ISPB (Identifcador do Sistema de Pagamento Brazil) - the Brazilian Payment System identifier, an 8-digit value.
Type: string
Example:
30306294

branch required

Title: Branch
Description: Payee account branch without digit
Type: string
Max length: 4
Example:
1234

document_number required

Title: Payee's document number
Description: Payee ID. A government document number, such as a Social Security number (US) or Cadastro de Pessoas Físicas number (Brazil). Must be numeric with 11-14 digits.
Type: string
Max length: 14
Example:
12345678900

name required

Title: Payee account name
Description: Payee's account name
Type: string
Max length: 100
Example:
Sue Flay

payee_name required

Title: Payee Name
Description: Payee name
Type: string
Example:
Cristill Ball

payee_participant required

Title: Payee participant ID
Description: Participant's ISPB (Identifcador do Sistema de Pagamento Brazil) - the Brazilian Payment System identifier for the receiving bank, an 8-digit value.
Type: string
Example:
12345678

status required

Title: Pix-out Status
Description: Pix-out transaction status
Type: string
Must be one of the following:
CANCELLED
SETTLED
Example:
CANCELLED

description

Title: Description
Description: Text message from payer to receiver.
Type: string
Example:
Transaction description

external_movement_id

Title: External movement id
Description: The participant external movement ID
Type: string
Example:
12345678

initiator_document_number

Title: Initiator's document number
Description: Payment initiator document number when initiation_type is PAYMENT_INITIATOR. A government document number, such as a Social Security number (US) or Cadastro de Pessoas Físicas number (Brazil). Must be numeric with 11-14 digits.
Type: string
Max length: 14
Example:
12345678912345

purchase_amount

Title: Purchase amount
Description: Purchase amount
Type: number
Format: double
Example:
100.5

reason

Title: Pix-out cancellation reason
Description: Reason for Pix-out status CANCELLED
Type: string
Example:
Transaction stopped due to error at the Creditor Agent.
Creditor account number invalid or missing.
Account specified is blocked, prohibiting posting of transactions against it.
Creditor account number closed.
Creditor account type missing or invalid.
Transaction type not supported/authorized on this account.
Specific transaction/message amount is greater than allowed maximum.
Amount received is not the amount agreed or expected.
Identification of end customer is not consistent with associated account number.
Creditor or Ultimate Creditor identification code missing or invalid.
Value in Creditor Identifier is incorrect.
The order was rejected by the bank side (for reasons concerning content).
Waiting time expired due to incomplete order.
Associated message, payment information block or transaction was received after agreed processing cut-off date, i.e., date in the past.
Settlement of the transaction has failed.
Regulatory Reason.
Due to specific service offered by the Creditor Agent.

schedule_id

Title: Schedule Identifier
Description: Pismo scheduled transaction ID (created upon scheduling a transaction and is used when canceling a scheduled transaction)
Type: string
Example:
5633e370-0916-4799-96f6-3ae15112fb85

transaction_identification

Title: Transaction identification code
Description: Transaction ID. This field is returned from the Validate QR code endpoint.
Type: string
Max length: 14
Example:
16484851846841

transaction_type

Title: Pix-out transaction type
Description: Type of transaction: TRANSFER = simple transfer (purchases or cash only); CHANGE = transfer of cash in addition to purchase amount (only when initiated by a CHANGE type QR code); WITHDRAWAL = cash-only transaction (only when initiated by a WITHDRAWAL type QR code)
Type: string
Must be one of the following:
TRANSFER
CHANGE
WITHDRAWAL
Example:
TRANSFER

withdraw_amount

Title: Withdraw amount
Description: Amount of cash back returned to payer in excess of purchase amount
Type: number
Format: double
Example:
25.0

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "type": "object",
    "title": "Pix-out notification received",
    "description": "Event generated when the <a href='https://developers.pismo.io/pismo-docs/reference/post-pix-out-transfer' target='_blank'>Pix-out transfer</a> endpoint is called. For more information, see the <a href='https://developers.pismo.io/pismo-docs/docs/pix-instant-payments' target='_blank'>Pix-instant payments</a> guide. Also see the <a href='https://developers.pismo.io/pismo-docs/docs/pix-payments-data-events' target='_blank'>Pix payments data events</a> guide.",
    "examples": [
        {
            "domain": "pix",
            "event_type": "pix_out",
            "schema_version": 1,
            "org_id": "4ea21a59-7f4f-4087-aab6-a9a96733084a",
            "cid": "cid",
            "timestamp": "2023-10-25T18:29:19Z",
            "data": {
                "account_id": 1234589,
                "authorization_id": 123456,
                "end_to_end_id": "E0000000020210519134701363535166",
                "amount": 100,
                "status": "SETTLED",
                "authorization_datetime": "2022-01-01T15:00:00Z",
                "payee_name": "payee name",
                "payee_participant": "12345678",
                "schedule_id": "9c23477d-3f61-4697-b797-a9cf7fa60bc3",
                "client_request_id": "4ea21a59-7f4f-4087-aab6-a9a96733084a"
            }
        }
    ],
    "required": [
        "account_id",
        "amount",
        "authorization_datetime",
        "authorization_id",
        "client_request_id",
        "end_to_end_id",
        "initiation_type",
        "payee",
        "payee_name",
        "payee_participant",
        "status"
    ],
    "properties": {
        "account_id": {
            "type": "integer",
            "title": "Account ID",
            "description": "Pismo account ID",
            "examples": [
                123
            ]
        },
        "amount": {
            "type": "number",
            "format": "double",
            "title": "Pix-out amount",
            "description": "Pix-out amount",
            "examples": [
                125.5
            ]
        },
        "authorization_datetime": {
            "type": "string",
            "title": "Authorization datetime",
            "description": "Authorization date/time from the Pismo platform. A RFC 3339 date-time value, i.e., '2023-04-12T23:20:50.52Z'.",
            "format": "date-time",
            "examples": [
                "2021-10-29T11:00:00.000Z"
            ]
        },
        "authorization_id": {
            "type": "integer",
            "title": "Authorization ID",
            "description": "Pismo authorization ID",
            "examples": [
                123
            ]
        },
        "client_request_id": {
            "type": "string",
            "title": "Unique transaction ID",
            "description": "Client-generated unique transaction ID. This value cannot be repeated.",
            "maxLength": 36,
            "examples": [
                "bc0bc832-ca05-425e-95d4-a1bf48ada1cc"
            ]
        },
        "end_to_end_id": {
            "type": "string",
            "title": "Pix end to end ID",
            "description": "Pix end to end transaction ID. This field is a Brazil Central Bank (BCB) requirement to track Pix transactions. Basically, there are two steps to a Pix transaction: 1. Initialize a transaction and 2. Confirm a transaction. This field is sent to the BCB in both steps in order to identify all transaction information.",
            "examples": [
                "E0000000020210519134701363533333"
            ]
        },
        "initiation_type": {
            "type": "string",
            "title": "Payment initiation type",
            "description": "Initiated payment type:  `MANUAL` - Manually initiated. Key is not used - bank account, bank code, document number, and branch is used for identification. `DICT` - Diretorio de Identificadores de Contas de Transacapo (Transaction accounts identifier directory). Pix/DICT key is used for identification. `STATIC_QRCODE` - Reusable code that contains only the data necessary to complete a transaction. When using static QR code, the transaction amount must be provided manually. `DYNAMIC_QRCODE` - The amount and other details for a dynamic code are included automatically. `PAYMENT_INITIATOR` - Payment provider initiated. A payment initiator is a 3rd party that has obtained authorization from the Central Bank and has an Open Finance certification.",
            "maxLength": 50,
            "enum": [
                "MANUAL",
                "DICT",
                "STATIC_QRCODE",
                "DYNAMIC_QRCODE",
                "PAYMENT_INITIATOR"
            ],
            "examples": [
                "PAYMENT_INITIATOR"
            ]
        },
        "payee": {
            "type": "object",
            "required": [
                "account_number",
                "branch",
                "bank",
                "document_number",
                "name"
            ],
            "properties": {
                "account_number": {
                    "type": "string",
                    "title": "Account Number",
                    "description": "Payee account number",
                    "maxLength": 10,
                    "examples": [
                        "98765432"
                    ]
                },
                "bank": {
                    "type": "string",
                    "title": "Bank",
                    "description": "Payee's bank code - ISPB (Identifcador do Sistema de Pagamento Brazil) - the Brazilian Payment System identifier, an 8-digit value.",
                    "examples": [
                        "30306294"
                    ]
                },
                "branch": {
                    "type": "string",
                    "title": "Branch",
                    "description": "Payee account branch without digit",
                    "maxLength": 4,
                    "examples": [
                        "1234"
                    ]
                },
                "document_number": {
                    "type": "string",
                    "title": "Payee's document number",
                    "description": "Payee ID. A government document number, such as a Social Security number (US) or Cadastro de Pessoas F\u00edsicas number (Brazil). Must be numeric with 11-14 digits.",
                    "maxLength": 14,
                    "examples": [
                        "12345678900"
                    ]
                },
                "name": {
                    "type": "string",
                    "title": "Payee account name",
                    "description": "Payee's account name",
                    "maxLength": 100,
                    "examples": [
                        "Sue Flay"
                    ]
                }
            }
        },
        "payee_name": {
            "type": "string",
            "title": "Payee Name",
            "description": "Payee name",
            "examples": [
                "Cristill Ball"
            ]
        },
        "payee_participant": {
            "type": "string",
            "title": "Payee participant ID",
            "description": "Participant's ISPB (Identifcador do Sistema de Pagamento Brazil) - the Brazilian Payment System identifier for the receiving bank, an 8-digit value.",
            "examples": [
                "12345678"
            ]
        },
        "status": {
            "type": "string",
            "title": "Pix-out Status",
            "description": "Pix-out transaction status",
            "enum": [
                "CANCELLED",
                "SETTLED"
            ],
            "example": "CANCELLED"
        },
        "description": {
            "type": "string",
            "title": "Description",
            "description": "Text message from payer to receiver.",
            "examples": [
                "Transaction description"
            ]
        },
        "external_movement_id": {
            "type": "string",
            "title": "External movement id",
            "description": "The participant external movement ID",
            "examples": [
                "12345678"
            ]
        },
        "initiator_document_number": {
            "type": "string",
            "title": "Initiator's document number",
            "description": "Payment initiator document number when `initiation_type` is `PAYMENT_INITIATOR`. A government document number, such as a Social Security number (US) or Cadastro de Pessoas F\u00edsicas number (Brazil). Must be numeric with 11-14 digits.",
            "maxLength": 14,
            "examples": [
                "12345678912345"
            ]
        },
        "purchase_amount": {
            "type": "number",
            "format": "double",
            "title": "Purchase amount",
            "description": "Purchase amount",
            "examples": [
                100.5
            ]
        },
        "reason": {
            "type": "string",
            "title": "Pix-out cancellation reason",
            "description": "Reason for Pix-out status `CANCELLED`",
            "examples": [
                "Transaction stopped due to error at the Creditor Agent.",
                "Creditor account number invalid or missing.",
                "Account specified is blocked, prohibiting posting of transactions against it.",
                "Creditor account number closed.",
                "Creditor account type missing or invalid.",
                "Transaction type not supported/authorized on this account.",
                "Specific transaction/message amount is greater than allowed maximum.",
                "Amount received is not the amount agreed or expected.",
                "Identification of end customer is not consistent with associated account number.",
                "Creditor or Ultimate Creditor identification code missing or invalid.",
                "Value in Creditor Identifier is incorrect.",
                "The order was rejected by the bank side (for reasons concerning content).",
                "Waiting time expired due to incomplete order.",
                "Associated message, payment information block or transaction was received after agreed processing cut-off date, i.e., date in the past.",
                "Settlement of the transaction has failed.",
                "Regulatory Reason.",
                "Due to specific service offered by the Creditor Agent."
            ]
        },
        "schedule_id": {
            "type": "string",
            "title": "Schedule Identifier",
            "description": "Pismo scheduled transaction ID (created upon scheduling a transaction and is used when canceling a scheduled transaction)",
            "examples": [
                "5633e370-0916-4799-96f6-3ae15112fb85"
            ]
        },
        "transaction_identification": {
            "type": "string",
            "title": "Transaction identification code",
            "description": "Transaction ID. This field is returned from the Validate QR code endpoint. ",
            "maxLength": 14,
            "examples": [
                "16484851846841"
            ]
        },
        "transaction_type": {
            "type": "string",
            "title": "Pix-out transaction type",
            "description": "Type of transaction: `TRANSFER` = simple transfer (purchases or cash only); `CHANGE` = transfer of cash in addition to purchase amount (only when initiated by a `CHANGE` type QR code); `WITHDRAWAL` = cash-only transaction (only when initiated by a `WITHDRAWAL` type QR code)",
            "enum": [
                "TRANSFER",
                "CHANGE",
                "WITHDRAWAL"
            ],
            "example": "TRANSFER"
        },
        "withdraw_amount": {
            "type": "number",
            "format": "double",
            "title": "Withdraw amount",
            "description": "Amount of cash back returned to payer in excess of purchase amount",
            "examples": [
                25.0
            ]
        }
    }
}
{
    "domain": "pix",
    "event_type": "pix_out",
    "schema_version": 1,
    "org_id": "4ea21a59-7f4f-4087-aab6-a9a96733084a",
    "cid": "cid",
    "timestamp": "2023-10-25T18:29:19Z",
    "data": {
        "account_id": 1234589,
        "authorization_id": 123456,
        "end_to_end_id": "E0000000020210519134701363535166",
        "amount": 100,
        "status": "SETTLED",
        "authorization_datetime": "2022-01-01T15:00:00Z",
        "payee_name": "payee name",
        "payee_participant": "12345678",
        "schedule_id": "9c23477d-3f61-4697-b797-a9cf7fa60bc3",
        "client_request_id": "4ea21a59-7f4f-4087-aab6-a9a96733084a"
    }
}