Transactions payload

Tracking the right data to Castle is crucial to finding fraudsters. By tracking user and/or event details that represent important business aspects, such as amount and account balance in case you're dealing with transactions, you're more likely to be able to spot suspicious behaviors.

Today, Castle is launching a standardized way of tracking granular transaction data that will become viewable and searchable in the Explore view. Tracking transaction and payment method data to Castle lets you more effectively stop payment fraud. It can also be used to roll out a sophisticated transaction monitoring strategy that incorporates both behavioral signals and transaction details. Here is an example payload for sending a credit a card transaction to Castle:

  // ...
  "transaction": {
    "type": "$purchase",
    "id": "900b183a-9f6d-4579-8c47-9ddcccf637b4",
    "amount": {
      "type": "$fiat",
      "value": "499.99",
      "currency": "USD"
    "payment_method": {
      "type": "$card",
      "fingerprint": "f7d8svftd6",
      "holder_name": "John Doe",
      "bank_name": "Bank of Merica",
      "country_code": "US",
      "billing_address": {
        "line1": "60 Polk Street",
        "city": "San Francisco",
        "country_code": "US",
        "region_code": "CA",
        "postal_code": "94103"
      "card": {
        "bin": "54321",
        "last4": "1234",
        "exp_month": 1,
        "exp_year": 2000,
        "network": "$amex",
        "funding": "$credit"

In addition to Card purchases you can describe ACH, Crypto, Apple, PayPal transfers and much more. See the full transaction details in the API reference