Sent when funds are sent to a customer. If the funding originated from an application, application_id is populated.
funding_created_202607UUID of the webhook event. Webhooks which do not deliver successfully are retried. This will be the same across retry attempts for the same webhook.
The type of webhook being delivered — matches the webhook_event_type values from GET /webhooks/event_types/.
HMAC-SHA256 signature of the request body, base64-encoded and prefixed with sha256=. The HMAC key is your webhook secret token (not your API token), which you can fetch from the iwoca Notifications API or the Developer Portal. Verify this header to confirm the webhook is genuinely from iwoca and to mitigate replay attacks (by also checking that X-IW-Timestamp is recent). Retried deliveries get a fresh timestamp and therefore a fresh signature.
message = "{X-IW-Timestamp}.{raw_request_body}"
signature = "sha256=" + base64(hmac_sha256(secret, message))
Unix timestamp (seconds) at which the delivery was initiated. If this delivery is a retry of an earlier failed delivery, the timestamp is of the current attempt, not the original delivery.
Identifies the application this funding resulted from, if any. Omitted for fundings not associated with an application (e.g. pre-approval drawdowns).
The optional external_customer_id you sent in the POST /customers request when creating the customer
The amount transferred to the customer
The time at which the customer initiated the sending of the funds. This is usually when the funds were sent, except in cases where there was a delay.
The amount added on to the loan as a fee for this funding. This corresponds to the funding_amount and offer_fee_percentage.
A unique identifier for this funding
The duration of the loan. The end date of the loan is this many days from the first funding. (Later fundings from the same offer will show the same offer_duration_in_days, but are due to be repaid by the same time as the original funding).
What percentage of the amount borrowed was added to the loan as a fee when the customer took the money
Identifies the formal offer that the customer accepted. The fields offer_max_amount, offer_monthly_interest_percentage, offer_fee_percentage and offer_duration_in_days will be the same for fundings that have the same offer_id, because these are properties of the offer. They correspond to fields in the /offers endpoint and are duplicated here for convenience.
The maximum funding the customer can take from this offer.
Monthly interest rate as a percentage (e.g. 3.0 means 3% per month)
Return status code 200 or 201 to acknowledge receipt of the webhook. Any non-2XX response code will result in iwoca retrying the delivery.