Retrieve an event

Get one event with the snapshot of its subject.

data is the subject as it was when the event happened, not as it is now. mode is the mode of the key or session that caused it, which is live for every event during the beta, and api_version is the version of the event's shape. actor says who caused it: a person, an API key, a customer at checkout, or system when 402pay moved a payment along on its own.

Path

id string Required

The event's ID, such as evt_JxmQNXpkZZN8mpqE.

Errors

404 not_found

No event with that ID belongs to your business.
403 permission_denied

The event is about something a restricted key can't read. Events about API keys or the business need a key with full access.

Any request can also fail on its key or its body. See errors.

Request

curl "https://dash.402pay.co/api/v1/events/evt_JxmQNXpkZZN8mpqE" \  -H "Authorization: Bearer $PAY402_SECRET_KEY"

Response200 OK

{  "data": {    "id": "evt_JxmQNXpkZZN8mpqE",    "kind": "event",    "type": "payment.succeeded",    "subject": {      "kind": "payment",      "id": "pmt_QI02vLdJGd48hBbg"    },    "data": {      "id": "pmt_QI02vLdJGd48hBbg",      "kind": "payment",      "status": "succeeded",      "amount": 4900,      "currency": "USD",      "fee_payer": "business",      "customer_fee": 0,      "amount_received": 4900,      "reporting": {        "currency": "USD",        "amount": 4900,        "fee": 0,        "transaction_fee": 25,        "customer_fee": 0,        "net": 4875      },      "fee_rate_bps": 0,      "method": {        "rail": "crypto",        "asset": "USDC",        "network": "polygon",        "amount": "49.00",        "expected_amount": "49.00",        "overpaid_amount": null,        "from_address": "0x136e44a2738dea5217e8d6745463d2a9a84d1421",        "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20",        "explorer_url": "https://polygonscan.com/tx/0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20"      },      "settlement": {        "destination": "wallet",        "asset": "USDC",        "network": "polygon",        "amount": "49.00",        "wallet_id": "wal_1fIGZOrILmsCO0jw",        "address": "0x9a3c416D4A81669C01f4515bBDEB93C45d3813fe",        "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20",        "explorer_url": "https://polygonscan.com/tx/0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20"      },      "customer_id": "cst_gWFWcc7Ga0Pv7LSC",      "link_id": null,      "url": "https://checkout.402pay.co/checkout/2jrsrcxv7k",      "reference": "order_1042",      "metadata": {        "order_id": "1042"      },      "success_url": "https://example.com/thanks",      "cancel_url": "https://example.com/cart",      "expires_at": "2026-09-27T21:22:47.038Z",      "canceled_at": null,      "checkout_id": "chk_C5yhPQvPqpYgdDgj",      "description": "Pro plan, monthly",      "country": "US",      "failure_code": null,      "failure_message": null,      "confirmed_at": "2026-09-26T21:23:13.447Z",      "created_at": "2026-09-26T21:22:47.038Z",      "updated_at": "2026-09-26T21:23:13.447Z",      "events": [        {          "type": "created",          "created_at": "2026-09-26T21:22:47.038Z",          "data": null        },        {          "type": "method_selected",          "created_at": "2026-09-26T21:22:47.047Z",          "data": {            "rail": "crypto",            "asset": "USDC",            "network": "polygon"          }        },        {          "type": "detected",          "created_at": "2026-09-26T21:23:07.047Z",          "data": {            "amount": "49.00",            "network": "polygon",            "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20"          }        },        {          "type": "confirmation",          "created_at": "2026-09-26T21:23:08.647Z",          "data": {            "current": 1,            "required": 4          }        },        {          "type": "confirmation",          "created_at": "2026-09-26T21:23:10.247Z",          "data": {            "current": 2,            "required": 4          }        },        {          "type": "confirmation",          "created_at": "2026-09-26T21:23:11.847Z",          "data": {            "current": 3,            "required": 4          }        },        {          "type": "confirmation",          "created_at": "2026-09-26T21:23:13.447Z",          "data": {            "current": 4,            "required": 4          }        },        {          "type": "succeeded",          "created_at": "2026-09-26T21:23:13.447Z",          "data": null        }      ]    },    "actor": {      "kind": "system",      "id": null,      "name": null    },    "mode": "live",    "api_version": "v1",    "created_at": "2026-09-26T21:23:15.256Z"  }}