Client anti-fraud webhook for banking transaction
This webhook is called during banking operations such as instant pay transactions. Specifically, it would be called during the processing for the following endpoints:
- Pix-out transfer
- Pix reversal
- Pay bank slip
- Perform cash-out (integrated payments)
- Transfer funds
- Create installments payment
- Request authorization
- Create cash-in or cash-out
- Create transfer
Webhook specifications
Request fields
| Field | ;Type | Description | Req |
|---|---|---|---|
decision
|
string | Pismo decision Enum: [ " approve". "reject" ] |
Y |
id
|
string | Request ID | Y |
datetime
|
string | Call datetime in ISO 8601 format | Y |
account_id
|
string | Pismo account ID | Y |
currency_code
|
string | ISO 4217 currency code. For example: 986=Brazil, 840=US. | Y |
amount
|
number | Transaction amount | Y |
origin
|
string | Transaction origin:
Enum:[ " banking",
"instant-pay".
"onus"]
|
Y |
operation_type
|
string | Operation type:
Enum: [ " cashin",
"cashout" ]
|
Y |
processing_code
|
string | Processing code. For more information, refer to the Processing codes and transaction types guide. | Y |
entities
|
object | Details of entities related to the transaction. | N |
account
|
object | Account information. | N |
name
|
string | Customer name | N |
document_number
|
string | Customer government document number. | N |
creation_date
|
string | Creation datetime in ISO 8601 format. | N |
limits
|
object | Limits | N |
total
|
number | Total | N |
address
|
object | Address information. | N |
zipcode
|
string | Postal code | N |
phone
|
object | Phone information. | N |
area
|
string | Area code. | N |
country
|
string | Country code. | N |
number
|
string | Phone number | N |
metadata
|
object | Any JSON name-value pairs | N |
raw
|
object | Platform additional information forwarded to the anti-fraud system, varies according to origin. Sent only in on-us transactions. | N |
Sample request
{
"decision": "approve",
"id": "id",
"datetime": "2022-07-28T12:45:12.566Z",
"account_id": 102334690,
"currency_code": "986",
"amount": 20,
"origin": "banking",
"operation_type": "cashin",
"processing_code": "003100",
"entities": {
"account": {
"name": "Anne Arbor",
"document_number": "8675309",
"creation_date": "2023-01-01T05:00:00.000Z",
"limits": {
"total": 1000
},
"address": {
"zipcode": 8675309
},
"phone": {
"area": "415",
"country": "55",
"number": "8675309"
}
}
},
"metadata": {
"a": false,
"b": 1,
"c": "test",
"d": {
"d1": "4683bf0c-20d2-4a7f-8877-5f3e9b46252c",
"d2": false,
"d3": 15
}
}
}Response fields
| Field | Type | Description | Req |
|---|---|---|---|
decision
|
string | Client decision
Enum: [ " approve", "
reject"]
|
Y |
metadata
|
object | Any JSON name-value pairs | N |
Sample response
{
“decision”: “approve”,
“metadata”: {}
}Updated about 13 hours ago
Did this page help you?