Refund or cancel a payment transaction by merchant transaction ID

Refund a previously settled payment transaction using Merchant Transaction ID.

This endpoint processes full or partial refunds for completed payments. Refunded amounts will be returned to the customer's payment method.

This endpoint also cancels payments that are currently in the Revaly approvals flow using MerchantTransactionId.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length between 1 and 50

Merchant-provided unique identifier of the transaction to refund or cancel

Body Params

Request to refund or cancel a payment transaction using merchant transaction ID

string
required
length ≤ 50

Merchant-provided unique identifier for this refund/cancel transaction

integer | null
0 to 9223372036854776000

Refund amount in smallest currency unit (e.g., cents for USD).
If null or omitted, a full refund will be processed.

string
required
length between 1 and 50

Unique identifier of the customer associated with this transaction

Headers
string
enum
Defaults to 2.0

Selects the RAP API version for this request. New integrations should pin 2.1 (identical to 2.0 today; future refinements land there). Omit to use the base version (2.0). A value naming an unsupported version — including an empty value — returns HTTP 400; if the header is sent, it must name a supported version. See the API description for the full version policy.

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json