The webhook endpoint
Webhooks allow the Method API to notify your application when certain events occur.
To receive Webhook notifications, create a Webhook by registering a URL pointing to your application where triggered events should be sent to. This URL is where Method will send event information in an HTTPS POST request.
Handling webhooks
A Webhook event is considered successfully delivered when the corresponding URL endpoint responds with an HTTP status code of 200 within 5 seconds.
If the criteria is not met, Method will reattempt 4 more times with each new attempt being delayed according to an exponential backoff algorithm, where the delay period between each attempt exponentially increases.
Webhooks that consistently fail to respond with a 200 will automatically be disabled.
Webhook Objects
Unique identifier for the Webhook.
The event type to be sent to this URL. See Webhook Event Types.
The URL receiving the webhook event.
Additional data provided during creation. See metadata
Timestamp of when the Webhook was created.
Timestamp of when the Webhook was last updated.
Webhook event object
The identifier of the resource modified.
The event type. See Webhook Event Types.
The URL path pointing to the affected resource. Make a HTTP GET request to this path to retrieve the resource.
Webhook Event Types
Name | Description |
---|---|
account.create | A new Account was successfully created. |
account.update | An Account has been updated. |
sensitive.create | A new Sensitive was successfully created. |
sensitive.update | An Sensitive has been updated. |
account_verification_session.create | A new AccountVerificationSession was successfully created. |
account_verification_session.update | An AccountVerificationSession has been updated. |
balance.create | A new Balance was successfully created. |
balance.update | A Balance has been updated. |
card_brand.create | A new CardBrand was successfully created. |
card_brand.update | A CardBrand has been updated. |
connect.create | A new Connect was successfully created. |
connect.update | A Connect has been updated. |
credit_score.create | A new CreditScore was successfully created. |
credit_score.update | A CreditScore has been updated. |
entity.create | A new Entity was successfully created. |
entity.update | An Entity has been updated. |
entity_verification_session.create | A new EntityVerificationSession was successfully created. |
entity_verification_session.update | An EntityVerificationSession has been updated. |
identity.create | A new Identity was successfully created. |
identity.update | An Identity has been updated. |
payment.create | A new Payment was successfully created. |
payment.update | A Payment has been updated. |
payment_reversal.create | A new PaymentReversal was successfully created. |
payment_reversal.update | A PaymentReversal has been updated. |
payoff.create | A new Payoff was successfully created. |
payoff.update | A Payoff has been updated. |
product.create | A new Product was successfully created. |
product.update | A Product has been updated. |
report.create | A new Report was successfully created. |
report.update | A Report has been updated. |
subscription.create | A new Subscription was successfully created. |
subscription.update | A Subscription has been updated. |
transaction.create | A new Transaction was successfully created. |
transaction.update | A Transaction has been updated. |
update.create | A new Update was successfully created. |
update.update | An Update has been updated. |