Reversal of a transaction

put

https://{host}/payout/v1/transactions/{transactionId}/reverse

Reversal of the transaction if received in error, or if a failure in some other part of the system requires the rollback of a transaction

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

transactionId

string

required

Unique identifier for the transaction resource.

Query Params

targetAudience

string

Defaults to AGENT_FACING

Identifies the client. Error messages and attribute metadata tailored to client [agent (store client) vs consumer (digital client)]

userLanguage

string

required

Defaults to EN-US

Language used by the user/operator

agentPartnerId

string

required

Defaults to 30150535

Unique agent or partner identifier

posId

string

Point of sale identifier of the client performing the API Call

operatorId

string

Operator name or ID of the user performing the transaction. Name or ID must be populated from the agent/partner system and cannot be edited by the user.

Body Params

The request payload with payout details for reversal of the transaction.

referenceNumber

string

required

MoneyGram's reference number for the transaction

retryIndicator

boolean

If agent application has sent a receive reversal request and did not receive a response, the application can retry the receive reversal request again and set this indicator to true

receiveReversalReasonCode

string

enum

required

Reason for the reversal of transaction based on enumerated values

Allowed:

Headers

X-MG-ClientRequestId

string

Defaults to 4c79b06f-a2af-4859-82c8-28cbb0bf361b

Client Request Id that can be passed by the client application. Client request Id must be unique within a single session for unique requests. This attribute can be used for ensuring idempotent request processing for some APIs. MoneyGram recommends using a UUID for the value of this field.

X-MG-ConsumerIPAddress

string

IP Address of the system initiating the session.

Responses

200OK

400Bad request. Returns error details.

401Unauthorized. Returns error details.

403Forbidden. Returns error details.

500Internal server error. Returns error details.