---
title: "Reverse orchestration payment"
method: POST
path: "/v4/orchestration/payment/reversal"
tags: ["Orchestration payments"]
---

# Reverse orchestration payment

`POST /v4/orchestration/payment/reversal`

Reverses the orchestration payment with customer end-to-end ID.

## Request body

- OrchestrationPaymentReversalRequest — Use this JSON request object to reverse a payment.
  - `sender_end_to_end_id` string, required — Unique ID that the sender can specify.
  - `original_payment_id` string, required — Unique ID of the payment that should be reversed.
  - `reversal_reason` PaymentReversalReasonRos, required — A structured object detailing reasons for a payment reversal.
    - `code` 'RB001' | 'RB002' | 'RB003' | 'RB004' | 'RB005' | 'RB008' | 'RB009' | 'RB010' | 'RB011' | 'RB012' | 'RB013' | 'RB017' | 'RB018' | 'RB023' | 'RB024' | 'RB026' | 'RB027' | 'RB028' | 'RB029' | 'RB030' | 'RB031' | 'RB032' | 'RB033' | 'RB034' | 'RB035' | 'RB036' | 'RB037' | 'AC01' | 'AC03' | 'AC04' | 'AC06' | 'AC08' | 'AC09' | 'AC11' | 'AC12' | 'AC13' | 'AC14' | 'AC15' | 'AG01' | 'AG02' | 'AG03' | 'AG05' | 'AG06' | 'AM02' | 'AM03' | 'AM04' | 'AM11' | 'AM13' | 'AM14' | 'AM15' | 'AM21' | 'AM22' | 'BE01' | 'BE04' | 'BE05' | 'BE06' | 'BE07' | 'BE08' | 'BE09' | 'BE10' | 'BE11' | 'BE12' | 'BE13' | 'BE14' | 'BE15' | 'BE16' | 'BE17' | 'BE18' | 'BE19' | 'BE20' | 'BE21' | 'BE22' | 'CERI' | 'CH11' | 'CH12' | 'CH13' | 'CH14' | 'CH21' | 'CNOR' | 'CUST' | 'DS24' | 'DU05' | 'DUPL' | 'ED06' | 'FF03' | 'FF04' | 'FF05' | 'FF06' | 'FF07' | 'FF08' | 'FF10' | 'MD06' | 'MD07' | 'MS02' | 'MS03' | 'NARR' | 'RC01' | 'RC02' | 'RC04' | 'RC05' | 'RC07' | 'RC08' | 'RC10' | 'RC12' | 'RF01' | 'RR01' | 'RR02' | 'RR03' | 'RR04' | 'RR05' | 'RR06' | 'RR07' | 'RR10' | 'SL03', required — The code indicating the reason for payment reversal.
    - `description` string — User-defined string describing the reason for payment reversal.

## Response `201`

Successfully returned orchestration payment.

- OrchestrationPaymentSubmitResponse — JSON response object that represents an orchestration payment query ID.
  - `sender_end_to_end_id` string — Sender end-to-end ID.

---

[API](https://skmtc.net/ripple/apis/ripplenet-server-api.md) · [All operations](https://skmtc.net/ripple/apis/ripplenet-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ripple/ripplenet-server-api/revisions/7843f07ca150/schema)