Marqeta sends all webhook events as HTTP POST requests to your registered endpoint URL. Each request contains a JSON payload with the event type and the full Marqeta object associated with the triggering event. Events are grouped into categories: transaction events, card transition events, user transition events, business transition events, GPA order events, and charge-back events. Your endpoint m
A card authorization request was received by the Marqeta platform.
Content-Type:
transaction.authorization.clearing
A previously authorized transaction was cleared (settled).
Content-Type:
transaction.gpa.debit
Funds were debited from a cardholder general purpose account.
Content-Type:
transaction.gpa.credit
Funds were credited to a cardholder general purpose account.
Content-Type:
transaction.refund
A refund was applied to a card transaction.
Content-Type:
transaction.authorization.advice
A card authorization was declined.
Content-Type:
cardtransition.state.active
A card was activated and is ready for use.
Content-Type:
cardtransition.state.suspended
A card was suspended and temporarily unable to process transactions.
Content-Type:
cardtransition.state.terminated
A card was permanently terminated.
Content-Type:
cardtransition.fulfillment.issued
A physical card was issued and queued for fulfillment.
Content-Type:
cardtransition.fulfillment.shipped
A physical card has been shipped to the cardholder.
Content-Type:
cardtransition.fulfillment.delivered
A physical card was confirmed as delivered.
Content-Type:
usertransition
A cardholder user account transitioned to a new state.
Content-Type:
businesstransition
A business account holder transitioned to a new state.
Content-Type:
gpaorder.completion
A GPA funding order completed successfully.
Content-Type:
chargebacktransition
A chargeback transitioned to a new state in the dispute lifecycle.
Content-Type:
About AsyncAPI
The AsyncAPI specification describes event-driven APIs the way OpenAPI describes request/response APIs. A channel is the named pipe — a webhook URL, a Kafka topic, a WebSocket route, an MQTT subject — that producers and consumers publish or subscribe to. Each channel carries one or more messages with structured payloads, and an operation declares whether a given party sends or receives on that channel.