Overview

Webhooks are a way for you to get notified when something happens within our system that is related to your account. For example, when your customer finances a purchase with you.

Webhook Request

For each event, we will send a post request to the endpoint you specify in your webhook. The request will include a signature that you should verify to ensure that the request originate from Finove. This is done by verifying the signature with your webhook secret key. See Securing your webhooks for more information on verifying the signature.

POST /your-webhook

Webhook-Signature: sha256=f33e87e8960b16a1541c2fb2219a85c920f3bcf53d90de457ab694aa2392d3a8

{
    id: 'de451854-5836-4473-932d-cefbd3a6e33a', // Number of attempts
    type: 'payment.initialized',
    attemptCount: 1, // Number of attempts
    createdAt: 'Fri Sep 04 2020 14:54:48 GMT-0700 (Pacific Daylight Time)',
    sentAt: 'Fri Sep 04 2020 14:54:49 GMT-0700 (Pacific Daylight Time)',
    data: {...}, // Event data (For data type, see "Webhook events" table)
}

Expected Response

Our server expects to receive a 2xx response. If our server does not receive a 2xx response, we will retry the webhook request until we receive a success response. We will retry up to 15 times.