Receive Payout Outcome

This webhook is relevant only for platforms that provide their own capital to businesses.

Webhook endpoint for receiving payout execution outcome from the platform.

After finmid sends a payout instruction via Execute Payment Transaction, the platform must notify finmid of the outcome by calling this endpoint.

The platform sends a confirmation with either:

• SETTLED: the payment was successfully deposited into the beneficiary's bank account, including the settlement timestamp.
• FAILED: the payment could not be completed, including the failure reason.

Correlation

The finmid_idempotency_key in the request body is the same idempotency_key that finmid provided in the original Execute Payment Transaction request. It is used to match this confirmation to the original payout instruction.

Idempotency

This endpoint is idempotent on the finmid_idempotency_key. Sending the same confirmation multiple times will not cause duplicate processing. If a confirmation with the same key has already been received, the platform will receive a 409 - CONFLICT response.