---
title: "Simulate failed status for an outbound payment"
method: POST
path: "/v1/simulate/fail-payment"
tags: ["Simulation"]
---

# Simulate failed status for an outbound payment

`POST /v1/simulate/fail-payment`

Simulate failed status for an outbound payment

## Request body

- SimulateFailPaymentRequest — Parameters for failing a payment.
  - `failure_reason` string, required — State a reason for the payment failure.
  - `transaction_id` string, uuid, required — The id of the transaction to fail.

## Response `200`

Request to fail payment has completed

---

[API](https://skmtc.net/lorum/apis/auth-api.md) · [All operations](https://skmtc.net/lorum/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lorum/auth-api/revisions/f9b8935027e3/schema)