---
title: "Refund payin"
method: POST
path: "/payins/{id}/refund"
tags: ["Payins"]
---

# Refund payin

`POST /payins/{id}/refund`

Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded.
For bank wire payins, a `bankaccount_id` is required to specify the refund destination.

## Path parameters

- `id` integer, required

## Request body

- object
  - `amount` number — Amount to refund. Defaults to full amount if not provided.
  - `multipayin` 0 | 1 — Set to `1` to refund all payins associated with the order of this payin.
  - `bankaccount_id` integer — Required if the payin is of Bankwire type. Bank account ID to receive the refund.
  - `tag` string
  - `metadata` object

## Response `200`

Payin with refund details

- Payin
  - `id` integer
  - `self` string
  - `reference` string, nullable — Provider's payment reference ID.
  - `type` string — Payment method type (e.g. `CARD`, `BANKWIRE`, `WALLET`).
  - `subtype` string, nullable
  - `status` 'CREATED' | 'AUTHORIZED' | 'CONFIRMED' | 'DENIED' | 'REFUNDED' | 'CANCELLED'
  - `provider` object — Raw provider response data.
  - `tag` string, nullable
  - `direct_link` string, uri, nullable — Payment page URL. Only present when status is `CREATED` or `AUTHORIZED`.
  - `created_at` string, date-time, nullable
  - `confirmed_at` string, date-time, nullable
  - `denied_at` string, date-time, nullable
  - `connections` Connections — Hypermedia links to related resources.

## Other responses

- `403` — Refunds not supported for this payment method
- `422` — Validation error

## Changes

- **2026-03-11** `ff825f6602c8` — 1 info
  - added the new optional request property `multipayin`

[Change history](https://skmtc.dev/truust-io/apis/truust-api/changes/payins/:id/refund/post.md)

---

[API](https://skmtc.dev/truust-io/apis/truust-api.md) · [All operations](https://skmtc.dev/truust-io/apis/truust-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/truust-io/truust-api/revisions/cc81e28726b9/schema)