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:


Webhook specifications
Request fields
;
FieldType 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”: {}
 }

Did this page help you?