Webhook payloads

A quick reference for event data sent to your webhooks.

Webhook payload examples

Below are sample webhook payloads that will be sent to the configured webhook URL when an event is triggered:

card.created payload

{
  "event": "card.created",
  "card": {
    "status": "Active",
    "card_account_id": "00c96cd0-0e28-48c1-a8f0-63edba69276d",
    "last_four": "5181",
    "card_id": "beb8732c-d2ca-4422-b408-91bbe3e2aebf"
  },
  "occurred_at": "2022-07-15T16:33:51.032050+00:00"
}

card.status.active payload

{
  "event": "card.status.active",
  "card": {
    "card_id": "9e30d021-3f39-4fcc-935b-e286d7f52807",
    "status": "Active",
    "last_four": "3351"
  },
  "occurred_at": "2022-07-15T19:46:50.778488+00:00"
}

card.status.closed payload

{
  "event": "card.status.closed",
  "card": {
    "card_id": "5475ad4b-1ae8-4e9e-b4c2-d1badff35564",
    "status": "Closed",
    "last_four": "9472"
  },
  "occurred_at": "2022-07-15T17:10:19.903691+00:00"
}

card.status.fraud payload

{
  "event": "card.status.fraud",
  "card": {
    "status": "Fraud",
    "card_id": "ee98bd82-a63b-452b-b884-f672a33e8db0",
    "last_four": "3586"
  },
  "occurred_at": "2022-07-15T17:05:05.814836+00:00"
}

card.status.inactive payload

{
  "event": "card.status.inactive",
  "card": {
    "card_id": "ee98bd82-a63b-452b-b884-f672a33e8db0",
    "status": "Inactive",
    "last_four": "3586"
  },
  "occurred_at": "2022-07-15T17:05:11.905684+00:00"
}

card.status.lost payload

{
  "event": "card.status.lost",
  "card": {
    "card_id": "ee98bd82-a63b-452b-b884-f672a33e8db0",
    "status": "Lost",
    "last_four": "3586"
  },
  "occurred_at": "2022-07-15T17:05:15.732863+00:00"
}

card.status.reissue payload

{
  "event": "card.status.reissue",
  "card": {
    "status": "Reissue",
    "card_id": "ee98bd82-a63b-452b-b884-f672a33e8db0",
    "last_four": "3586"
  },
  "occurred_at": "2022-07-15T17:05:52.316767+00:00"
}

card.status.stolen payload

{
  "event": "card.status.stolen",
  "card": {
    "status": "Stolen",
    "card_id": "ee98bd82-a63b-452b-b884-f672a33e8db0",
    "last_four": "3586"
  },
  "occurred_at": "2022-07-15T17:05:25.784799+00:00"
}

kyc.verification.document_required payload

{
  "event": "kyc.verification.document_required",
  "occurred_at": "2022-07-15T19:00:13.408384+00:00",
  "documents": [
    {
      "document_type": "government_id",
      "upload_link": "https://withpersona.com/verify?inquiry-id=inq_GyBgudfcahH2XxKoyok96TCJ",
      "status": "required"
    },
    {
      "status": "required",
      "upload_link": "https://withpersona.com/verify?inquiry-id=inq_usqKneQS98WDvPnGgihZsH5J&template-id=vtmpl_2SP5t15iV1S8mECrUsdckevx",
      "document_type": "proof_of_address"
    },
    {
      "status": "required",
      "upload_link": "https://withpersona.com/verify?inquiry-id=inq_znpSsrt8DHSEkP4FD6kYUQs9&template-id=vtmpl_X9v7uAX8PdK8ptdtySR3oGSK",
      "document_type": "social_security_card"
    }
  ],
  "customer_id": "66c623b7-0fd8-4104-923c-f4b168e0bf00"
}

kyc.verification.under_review payload

{
  "event": "kyc.verification.under_review",
  "customer_id": "1d48c087-f68e-48ab-b779-a15a3dca4c27",
  "occurred_at": "2022-07-15T16:54:12.058527+00:00"
}

kyc.verification.success payload

{
  "event": "kyc.verification.success",
  "customer_id": "1d48c087-f68e-48ab-b779-a15a3dca4c27",
  "occurred_at": "2022-07-15T16:36:46.167945+00:00"
}

kyc.verification.failure payload

{
  "event": "kyc.verification.failure",
  "customer_id": "1d48c087-f68e-48ab-b779-a15a3dca4c27",
  "occurred_at": "2022-07-15T16:41:10.284335+00:00"
}

kyc.verification.timeout payload

{
  "event": "kyc.verification.timeout",
  "occurred_at": "2022-07-15T19:10:50.187657+00:00",
  "customer_id": "6c83e28d-f93b-4446-86e4-a68b414a39e6"
}

kyb.verification.approved payload

{
  "event": "kyb.verification.approved",
  "business_id": "0b84df2b-c344-4e70-a496-ecec769a84af",
  "occurred_at": "2022-07-15T17:06:41.122010+00:00"
}

transactions payload

Below are examples for each type of transaction (card, ACH, and account):

Card payment payload
{
  "event": "transactions",
  "transaction": {
    "transaction_id": "f3d106b6-45b3-45bd-be44-7c56687cc58a",
    "bond_brand_id": "00000000-0000-0000-0000-000000000000",
    "customer_id": "90513b2a-bfe9-4f8a-8eb7-53a62ae17f6e",
    "account_id": "5f7fbde2-520f-4805-8dcd-848b5aa0298a",
    "payment_type": "card",
    "transaction_type": "POS Purchase",
    "state": "pending",
    "description": "Pre-Auth Transaction-POS Signature Purchase - Partial Amount",
    "amount": "-21.93",
    "fee": "0.00",
    "currency": "USD",
    "created_time": "2022-07-15T18:57:28+00:00",
    "updated_time": "2022-07-15T18:57:28+00:00",
    "balances": {
      "prior_balance": "-38.07",
      "new_balance": "-60.00"
    },
    "details": {
      "card_id": "02045f3a-4e4e-4b79-84cc-f45e9427674a",
      "mcc": "5814",
      "mcc_description": "Fast Food",
      "currency": "USD",
      "exchange_rate": "1.00",
      "merchant_id": "4445197736264",
      "merchant_name": "Wendy'S #878",
      "merchant_city": "SAN BRUNO    ",
      "merchant_state": "CA",
      "merchant_currency": "USD",
      "merchant_amount": "-22.72",
      "cardholder_presence": true,
      "statement_descriptor": "WENDY'S #878             SAN BRUNO    CAUSA"
    }
  },
  "occurred_at": "2022-06-28T15:38:50.473639+00:00"
}
ACH transfer payload
{
  "event": "transactions",
  "transaction": {
    "transaction_id": "337f8357-babc-4362-b814-fa2c5aaf19b6",
    "bond_brand_id": "00000000-0000-0000-0000-000000000000",
    "customer_id": "08dcd97e-bacb-4da3-bd36-2a8e5655400e",
    "account_id": "b9302eb7-c9ce-4487-a790-d31d12448b34",
    "payment_type": "ach",
    "transaction_type": "ACH Deposit",
    "state": "pending",
    "amount": "0.01",
    "currency": "USD",
    "created_time": "2022-07-15T16:08:54.226382+00:00",
    "updated_time": "2022-07-15T16:08:54.226382+00:00",
    "balances": {
      "prior_balance": "49.00",
      "new_balance": "49.00"
    },
    "details": {
      "card_id": "3a69d8ba-29c1-4541-8b6d-d52aebd708f7",
      "external_account_id": "bfe86340-a3f9-49fd-b278-0bff7346041c",
      "class_code": "WEB",
      "direction": "debit",
      "network": "same-day-ach",
      "description": "Test"
    }
  },
  "occurred_at": "2022-06-23T16:22:06.612669+00:00"
}
Card-to-card transfer payload
{
  "event": "transactions",
  "transaction": {
    "transaction_id": "0721ae9e-616b-4af8-864c-3b7c8b740424",
    "bond_brand_id": "5ca99020-807b-45fa-897f-c0fbf90be275",
    "customer_id": "4a70f31c-4e2e-4566-b867-642e3470dab2",
    "account_id": "d5b95905-9421-47c0-beb7-ddd6a26e25a8",
    "payment_type": "account",
    "transaction_type": "Card to Card Transfer",
    "state": "completed",
    "amount": "10.00",
    "currency": "USD",
    "created_time": "2022-07-15T19:41:35+00:00",
    "updated_time": "2022-07-15T19:41:35+00:00",
    "balances": {
      "prior_balance": "180.01",
      "new_balance": "190.01"
    },
    "details": {
      "origination_card_id": "9e30d021-3f39-4fcc-935b-e286d7f52807",
      "destination_card_id": "66ce7043-1a1f-48b2-9240-82be0ed0f539"
    }
  },
  "occurred_at": "2022-06-23T16:22:06.943717+00:00"
}

Did this page help you?