> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# API - Feb 3, 2025

Added

## Payout PaymentRef for refunding bank wire pay-in

Platforms can now provide information about the initial pay-in on a payout that is being used to reimburse it. This is possible thanks to the new `PaymentRef` parameter on the [Payout](/api-reference/payouts/payout-object) object.

The `PaymentRef` must be sent on payouts that are reimbursing [bank wire pay-ins](/api-reference/bank-wire-payins/create-bank-wire-payin) and [pay-ins to virtual IBANs](/api-reference/virtual-accounts/view-payin-external-instruction), for which the [Refund](/api-reference/refunds/refund-object) object is not available.

To refund these pay-ins, platforms must provide the `Id` of the initial pay-in as the `ReferenceId` value, and set the `ReasonType` to `PAYIN_REFUND`.

For more details, see the new [Refunds using payouts](/guides/payouts/integration#refunds-using-payouts) section of the payouts guide, as well as the response example in the [endpoints](/api-reference/payouts/create-payout).

#### [Guide](/guides/payouts/integration#refunds-using-payouts)

Refunds using payouts