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 wheninitiation_type
isPAYMENT_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
internal required
Title: Internal transaction
Description: Internal transaction informs if the transaction was made inside Pismo (between accounts at the same Org), in this case, the SPI was not called
Type: boolean
Example:
true
false
is_device_registered
Title: Is Device Registered
Description: Registered Device is about the limit that the device in question can make a pix transaction
Type: boolean
Example:
true
false
error_code
Title: Pix-out Cancellation Error code
Description: Error code for Pix-out statusCANCELLED
, an 8-digit value.
Type: string
Max length: 8
Example:
EPIX0114
EPIX0134
reason
Title: Pix-out cancellation reason
Description: Reason for Pix-out statusCANCELLED
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 aCHANGE
type QR code);WITHDRAWAL
= cash-only transaction (only when initiated by aWITHDRAWAL
type QR code)
Type: string
Must be one of the following:
TRANSFER
CHANGE
WITHDRAWAL
Example:
TRANSFER
metadata
Title: Metadata
Description: Additional information relevant to the customer. No business rule validation is performed on it.
Type: object or null
Additional properties: true
Example:{ "customer-data": { "my": "value", "my-custom-business-label": "label", "score": "123" } }
withdraw_amount
Title: Withdraw amount
Description: Amount of cash back returned to payer in excess of purchase amount
Type: number
Format: double
Example:
26.0
recurrence_pix
Type: object
scheduler_id required
Title: Scheduler Identifier
Description: Schedule identifier. This field refers to the identification of the recurring payment schedule.
Type: string
Max length: 36
Example:
2633e340-0915-4192-46fs-3ae15112fbq9
execution_id required
Title: Execution Identifier
Description: Schedule execution identifier. This field refers to the identification of the recurring payment execution
Type: integer
Example:
10010
{
"$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",
"internal": false,
"recurrence_pix": {
"scheduler_id": "c23477d-3f61-4697-b797-a9cf7fa60bc3",
"execution_id": 10010
},
"is_device_registered": false
}
}
],
"required": [
"account_id",
"amount",
"authorization_datetime",
"authorization_id",
"client_request_id",
"end_to_end_id",
"initiation_type",
"payee",
"payee_name",
"payee_participant",
"status",
"internal"
],
"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
]
},
"internal": {
"type": "boolean",
"title": "Internal transaction",
"description": "Internal transaction informs if the transaction was made inside Pismo (between accounts at the same Org), in this case, the SPI was not called",
"examples": [
true,
false
]
},
"is_device_registered": {
"type": "boolean",
"title": "Is Device Registered",
"description": "Registered Device is about the limit that the device in question can make a pix transaction",
"examples": [
true,
false
]
},
"error_code": {
"type": "string",
"title": "Pix-out Cancellation Error code",
"description": "Error code for Pix-out status `CANCELLED`, an 8-digit value.",
"maxLength": 8,
"examples": [
"EPIX0114",
"EPIX0134"
]
},
"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"
},
"metadata": {
"type": [
"object",
"null"
],
"title": "Metadata",
"description": "Additional information relevant to the customer. No business rule validation is performed on it.",
"examples": [
{
"customer-data": {
"my": "value",
"my-custom-business-label": "label",
"score": "123"
}
}
],
"additionalProperties": true
},
"withdraw_amount": {
"type": "number",
"format": "double",
"title": "Withdraw amount",
"description": "Amount of cash back returned to payer in excess of purchase amount",
"examples": [
26.0
]
},
"recurrence_pix": {
"type": "object",
"required": [
"scheduler_id",
"execution_id"
],
"properties": {
"scheduler_id": {
"type": "string",
"title": "Scheduler Identifier",
"description": "Schedule identifier. This field refers to the identification of the recurring payment schedule.",
"maxLength": 36,
"examples": [
"2633e340-0915-4192-46fs-3ae15112fbq9"
]
},
"execution_id": {
"type": "integer",
"title": "Execution Identifier",
"description": "Schedule execution identifier. This field refers to the identification of the recurring payment execution",
"examples": [
10010
]
}
}
}
}
}
{
"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",
"internal": false,
"recurrence_pix": {
"scheduler_id": "c23477d-3f61-4697-b797-a9cf7fa60bc3",
"execution_id": 10010
},
"is_device_registered": false
}
}
Updated 4 days ago