> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dollarpe.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# December 2025

> Payin status flow updates, refund reason tracking, selfie verification endpoint, and webhook metadata documentation.

## Payin status updates

<Badge>New</Badge>

* Added `REFUND_INITIATED` state to the payin status flow. Payin status now moves through `REFUND_INITIATED` before reaching `REFUNDED`.
* Updated [Status Reference](/guides/development-and-testing/status-reference#payin-status) to reflect the new flow.

## Refund reason updates

<Badge>New</Badge>

* Added `refund_reason` field to payin refund events. Available in:

  * API Responses: [Fetch payin](/api-reference-exchange/endpoint/payin/\{payin_id}) and [Payin history](/api-reference-exchange/endpoint/payin/history) endpoints.
  * Webhook Payloads: Payin events for `REFUND_INITIATED` and `REFUNDED` states.

* Possible `refund_reason` values:

  * `INCORRECT_AMOUNT` - The amount transferred does not match the expected amount for the payin quotation.
  * `PAYMENT_FROM_NON_WHITELISTED_ACCOUNT` - Payment came from an account not whitelisted for the customer.
  * `THIRD_PARTY_PAYMENT` - Payment came from a third-party account not associated with the customer.

## Selfie verification updates

<Badge>New</Badge>

* Added [Update Selfie Information](/api-reference-exchange/endpoint/kyc/update-selfie-info) endpoint. Customers can update selfie data up to 3 times.
* Added `SELFIE_VERIFICATION_FAILED` failure reason to the KYC process. Returned when:
  * Selfie image quality is poor or the face is not clearly visible.
  * Selfie does not match the photo on submitted KYC documents.
* Updated [Failure Reason Reference](/api-reference-exchange/appendix/failure-reason-reference#customer-verification) to include `SELFIE_VERIFICATION_FAILED`.

## Webhooks metadata

<Badge>Improved</Badge>

* Updated [Webhooks](/guides/development-and-testing/webhooks) docs with metadata field details:
  * Payin Events: `failure_reason` for `FAILED` events, `refund_reason` for `REFUND_INITIATED` and `REFUNDED` events.
  * Customer Events: `failure_reason` for `FAILED` events (including `SELFIE_VERIFICATION_FAILED`).
  * Bank Events: `failure_reason` for `FAILED` events.
* Added webhook payload examples with actual failure and refund reason values.