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, so an event stored before October 7, 2026 keeps the integer amounts in minor units it was written with. mode is always live, 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.
On an *.updated event, previous_attributes holds the top-level fields of data that changed, with the values they had before (null for a field that was new), so you can tell what changed without keeping a copy. updated_at is left out, since it moves with every change. It's null on every other event.
Path
idstring RequiredThe event's ID, such asevt_JxmQNXpkZZN8mpqE.
Errors
- 404
not_foundNo event with that ID belongs to your business. - 403
permission_deniedThe 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.
curl "https://api.402pay.co/api/v1/events/evt_JxmQNXpkZZN8mpqE" \ -H "Authorization: Bearer $PAY402_SECRET_KEY"{ "data": { "id": "evt_JxmQNXpkZZN8mpqE", "kind": "event", "type": "payment.succeeded", "subject": { "kind": "payment", "id": "pmt_QI02vLdJGd48hBbg" }, "data": { "id": "pmt_QI02vLdJGd48hBbg", "kind": "payment", "status": "succeeded", "amount": "49.00", "currency": "USD", "fee_payer": "business", "customer_fee": "0.00", "amount_received": "49.00", "reporting": { "currency": "USD", "amount": "49.00", "fee": "0.00", "transaction_fee": "0.25", "customer_fee": "0.00", "net": "48.75" }, "fee_rate_bps": 0, "method": { "rail": "crypto", "asset": "USDC", "network": "ethereum", "amount": "49.00", "expected_amount": "49.00", "overpaid_amount": null, "from_address": "0x136e44a2738dea5217e8d6745463d2a9a84d1421", "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20", "explorer_url": "https://etherscan.io/tx/0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20", "integration": null }, "settlement": { "destination": "wallet", "asset": "USDC", "network": "ethereum", "amount": "49.00", "wallet_id": "wal_1fIGZOrILmsCO0jw", "address": "0x9a3c416D4A81669C01f4515bBDEB93C45d3813fe", "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20", "explorer_url": "https://etherscan.io/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:10.247Z", "marked_paid": null, "created_at": "2026-09-26T21:22:47.038Z", "updated_at": "2026-09-26T21:23:10.247Z", "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": "ethereum" } }, { "type": "detected", "created_at": "2026-09-26T21:23:07.047Z", "data": { "amount": "49.00", "network": "ethereum", "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20" } }, { "type": "confirmation", "created_at": "2026-09-26T21:23:08.647Z", "data": { "current": 1, "required": 2 } }, { "type": "confirmation", "created_at": "2026-09-26T21:23:10.247Z", "data": { "current": 2, "required": 2 } }, { "type": "succeeded", "created_at": "2026-09-26T21:23:10.247Z", "data": null } ] }, "previous_attributes": null, "actor": { "kind": "system", "id": null, "name": null }, "mode": "live", "api_version": "v1", "created_at": "2026-09-26T21:23:15.256Z" }}