---
title: "Return a stablecoin payout"
method: POST
path: "/v1/payouts/stablecoin/{payoutId}/refund"
tags: ["Refunds"]
---

# Return a stablecoin payout

`POST /v1/payouts/stablecoin/{payoutId}/refund`

## Request

- Base URL: `https://api.sandbox.alfredpay.io`
- URL: `https://api.sandbox.alfredpay.io/v1/payouts/stablecoin/{payoutId}/refund`
- Auth: one of:
  - HTTP bearer
  - API key in header `api-key` and API key in header `api-secret`

Same two behaviors as the fiat refund. Before the transfer is accepted it unwinds the lock. After that it requests return of the funds and completes on confirmed receipt. Only valid while the payout is non-terminal.

**Wait on** `refund.updated`. See [Webhooks and events](/docs/webhooks-and-events).

## Headers

- `Idempotency-Key` string, uuid, required

## Response `202`

Accepted

- RefundAction
  - `actionId` string
  - `actionType` 'REFUND'
  - `parentTransactionId` string
  - `status` 'REQUESTED' | 'PROCESSING' | 'COMPLETED' | 'DECLINED'
  - `parentOutcome` 'CANCELLED' | 'null', nullable: The parent lands CANCELLED whether unwound pre-execution or returned after a leg went out.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `409`: `parent_terminal`: the transaction has reached COMPLETE, FAILED, CANCELLED or BLOCKED. No action reaches back into it; recovering value is a new transaction.

## Changes

- **2026-11-03** `20fef4fd2ab3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/changes/v1/payouts/stablecoin/:payoutId/refund/post.md)

---

[API](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation.md) - [All operations](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/revisions/20fef4fd2ab3?raw)