Webhooks
Overview
Webhooks are a way to customize your software with real time updates from Partial.ly. Partial.ly can send any URL you specify details when specific events occur, such as a payment plan being opened, payment succeeded, or a payment fails.
Webhooks will post a JSON formatted document to your URL. To verify that the webhook is coming from Partial.ly, and that the data has not been tampered with, Partial.ly will also add the Partially-Signature header to the webhook request. The value of this header will be the sha-256 HMAC of the posted body, using your your API key as the secret key. Your API key can be found in your Partial.ly merchant portal by going to Settings and then general.
Configuring webhooks
To add a webhook, log in to the Partial.ly merchant portal, click Settings, then webhooks.
You can also test your webhook by sending fake events using the webhook testing tool, by clicking the Test webhooks link on the webhook settings page. This will send a test webhook to the URL you provide, and display the request and response bodies.
Webhook format
All webhooks will have the following keys:
- event
- The type of event
- id
- The id of the event
- data
- Data specific to the event
The following events are currently supported:
- plan_opened
- Sent when a new payment plan is opened
- payment_succeeded
- Sent when a scheduled payment is successful
- payment_failed
- Sent when a scheduled payment fails
- plan_paid
- Sent when a payment plan is fully paid
- plan_defaulted
- Sent when a payment plan defaults due to 3 consecutive failed payments
- plan_canceled
- Sent when a payment plan is canceled
- refund_created
- Sent when a new refund is created
- dispute_created
- Sent when a new dispute is created
- dispute_closed
- Sent when a dispute is won or lost
- checkout_abandoned
- Sent when a Partial.ly checkout is abandoned, as defined by configuration settings
For full details on working with webhooks, see our webhook developer documentation.