Pix-in notification received

Internal-only endpoint. This flow is started by our partner's webhook, after successfully cashing in, this event is sent. For more information, see the Pix instant payments guide.

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

account_id required

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

amount required

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

authorization_datetime required

Title: Authorization Datetime
Description: Pismo authorization datetime. 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

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

payer required

Type: object

account_number required

Title: Account Number
Description: Pix payer's account number including verifier
Type: string
Max length: 10
Example:
98765432

bank required

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

branch required

Title: Branch
Description: Pix payer's branch code without digit
Type: string
Max length: 4
Example:
1234

document_number required

Title: Pix payer's document number
Description: Pix payer's federal document number, 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: Pix payer's account name
Description: Pix payer's account name
Type: string
Max length: 100
Example:
Rick Shaw

payer_name required

Title: Pix-in Payer Name
Description: Name of payer in Pix-in transaction
Type: string
Example:
Sonny Day

payer_participant required

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

status required

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

description

Title: Description
Description: Transaction description shown to the payer so that they can enter relevant information to be sent to the payee.
Type: string
Example:
Transaction description

external_movement_id

Title: External movement id
Description: Payer participant's movement identifier
Type: string
Example:
12345678

reason

Title: Pix-in Cancellation Reason
Description: Reason for Pix-in 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.

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "type": "object",
    "title": "Pix-in notification received",
    "description": "Internal-only endpoint. This flow is started by our partner's webhook, after successfully cashing in, this event is sent. For more information, see the <a href='https://developers.pismo.io/pismo-docs/docs/pix-instant-payments' target='_blank'>Pix instant payments</a> guide.",
    "examples": [
        {
            "domain": "pix",
            "event_type": "pix_in",
            "schema_version": 1,
            "org_id": "TN-34778262-f4f0-464d-b4c6-a14e2dc6xxx",
            "cid": "468fa881-fee5-4d6e-aa17-bbac0a1df0a5",
            "timestamp": "2023-10-25T18:34:27Z",
            "data": {
                "account_id": 9837,
                "authorization_id": 123456789,
                "end_to_end_id": "E2198371298371",
                "amount": 15.34,
                "status": "SETTLED",
                "authorization_datetime": "2022-01-01T12:00:00Z",
                "payer_name": "Warren Piece",
                "payer": {
                    "account_number": "12345678",
                    "branch": "001",
                    "bank": "00992014",
                    "document_number": "12312312390",
                    "name": "Tad Pohl"
                },
                "description": "c45e06de-4dca-49a6-a5b0-c4799851cb0a",
                "external_movement_id": "12345678"
            }
        }
    ],
    "required": [
        "account_id",
        "amount",
        "authorization_datetime",
        "authorization_id",
        "end_to_end_id",
        "payer",
        "payer_name",
        "payer_participant",
        "status"
    ],
    "properties": {
        "account_id": {
            "type": "integer",
            "title": "Account ID",
            "description": "Pismo account ID",
            "examples": [
                123
            ]
        },
        "amount": {
            "type": "number",
            "format": "double",
            "title": "Pix-in Amount",
            "description": "Pix-in amount",
            "examples": [
                125.5
            ]
        },
        "authorization_datetime": {
            "type": "string",
            "title": "Authorization Datetime",
            "description": "Pismo authorization datetime. 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
            ]
        },
        "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"
            ]
        },
        "payer": {
            "type": "object",
            "required": [
                "account_number",
                "bank",
                "branch",
                "document_number",
                "name"
            ],
            "properties": {
                "account_number": {
                    "type": "string",
                    "title": "Account Number",
                    "description": "Pix payer's account number including verifier",
                    "maxLength": 10,
                    "examples": [
                        "98765432"
                    ]
                },
                "bank": {
                    "type": "string",
                    "title": "Bank",
                    "description": "Pix payer's bank code- ISPB (Identifcador do Sistema de Pagamento Brazil) - the Brazilian Payment System identifier, an 8-digit value.",
                    "maxLength": 8,
                    "examples": [
                        "30306294"
                    ]
                },
                "branch": {
                    "type": "string",
                    "title": "Branch",
                    "description": "Pix payer's branch code without digit",
                    "maxLength": 4,
                    "examples": [
                        "1234"
                    ]
                },
                "document_number": {
                    "type": "string",
                    "title": "Pix payer's document number",
                    "description": "Pix payer's federal document number, 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": "Pix payer's account name",
                    "description": "Pix payer's account name",
                    "maxLength": 100,
                    "examples": [
                        "Rick Shaw"
                    ]
                }
            }
        },
        "payer_name": {
            "type": "string",
            "title": "Pix-in Payer Name",
            "description": "Name of payer in Pix-in transaction",
            "examples": [
                "Sonny Day"
            ]
        },
        "payer_participant": {
            "type": "string",
            "title": "Payer Participant ID",
            "description": "Payer's ISPB (Identifcador do Sistema de Pagamento Brazil) - the Brazilian Payment System identifier for the receiving bank, an 8-digit value.",
            "maxLength": 8,
            "examples": [
                "12345678"
            ]
        },
        "status": {
            "type": "string",
            "title": "Pix-in status",
            "description": "Pix-in status",
            "enum": [
                "CANCELLED",
                "SETTLED"
            ],
            "examples": [
                "CANCELLED"
            ]
        },
        "description": {
            "type": "string",
            "title": "Description",
            "description": "Transaction description shown to the payer so that they can enter relevant information to be sent to the payee.",
            "examples": [
                "Transaction description"
            ]
        },
        "external_movement_id": {
            "type": "string",
            "title": "External movement id",
            "description": "Payer participant's movement identifier",
            "examples": [
                "12345678"
            ]
        },
        "reason": {
            "type": "string",
            "title": "Pix-in Cancellation Reason",
            "description": "Reason for Pix-in 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."
            ]
        }
    }
}

{
    "domain": "pix",
    "event_type": "pix_in",
    "schema_version": 1,
    "org_id": "TN-34778262-f4f0-464d-b4c6-a14e2dc6xxx",
    "cid": "468fa881-fee5-4d6e-aa17-bbac0a1df0a5",
    "timestamp": "2023-10-25T18:34:27Z",
    "data": {
        "account_id": 9837,
        "authorization_id": 123456789,
        "end_to_end_id": "E2198371298371",
        "amount": 15.34,
        "status": "SETTLED",
        "authorization_datetime": "2022-01-01T12:00:00Z",
        "payer_name": "Warren Piece",
        "payer": {
            "account_number": "12345678",
            "branch": "001",
            "bank": "00992014",
            "document_number": "12312312390",
            "name": "Tad Pohl"
        },
        "description": "c45e06de-4dca-49a6-a5b0-c4799851cb0a",
        "external_movement_id": "12345678"
    }
}