Guides

Webhook payloads

Suggest Edits

Webhook payload examples

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

card

.created

The following is the 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"
}

.status.active

The following is the 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"
}

.status.closed

The following is the 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"
}

.status.fraud

The following is the 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"
}

.status.inactive

The following is the 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"
}

.status.lost

The following is the 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"
}

.status.reissue

The following is the 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"
}

.status.stolen

The following is the 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

The following is the 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"
}

.under_review

The following is the 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"
}

.success

The following is the 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"
}

.failure

The following is the 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"
}

.timeout

The following is the 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"
}

.approved

The following is the kyc.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

Below are payload examples for each type of transaction:

Card payment

The following is the 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

The following is the ACH transfer payload.

{
   "transaction_id": "b07b0290-47ff-47a0-9e70-4668508a8018",
   "bond_brand_id": "c17c0500-afce-40a5-b3b4-bb77bea04417",
   "customer_id": "b3e83408-4d42-4cf6-a139-f41c73e402f8",
   "account_id": "21074045-07b0-4bca-819a-462c3bdb5c3b",
   "payment_type": "card",
   "transaction_type": "POS Purchase",
   "state": "completed",
   "description": "POS Purchase",
   "amount": "-30.49",
   "currency": "USD",
   "created_time": "2023-12-16T19:42:05.721337+00:00",
   "updated_time": "2023-12-19T10:54:42.704103+00:00",
   "details": {
       "mcc": "5977",
       "mcc_description": "Cosmetic Stores",
       "currency": "USD",
       "exchange_rate": "1.000000",
       "merchant_id": "000174030076999",
       "merchant_name": "Paypal *Sephora Usa",
       "merchant_city": "4029357733",
       "merchant_currency": "USD",
       "merchant_amount": "-35.93",
       "cardholder_presence": false,
       "statement_descriptor": "PAYPAL *SEPHORA USA   4029357733   USAPAYPAL   *SEPHORA USA",
       "products": ["COSMETICS", "BEAUTY"],
       "settlements": [
            {
                "settlement_date": "2024-12-16T03:47:27+00",
                "amount": "-30.49"
            }
        ]
   },
   "balances": {}
}

Card-to-card transfer

The following is the 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"
}

Updated 15 days ago