Skip to content

createReversal.Readme.md

Latest commit

 

History

History
66 lines (48 loc) · 2.65 KB

createReversal.Readme.md

File metadata and controls

66 lines (48 loc) · 2.65 KB

Create A Reversal

Here, createReversal(String transactionReference) creates a POST request to /transactions/{transactionReference}/reversals

Provided with a valid object representation, this endpoint allows for a new reversal to be created.

Usage/Examples

MMClient mmClient = new MMClient("<Place your consumer key>", "<Place your consumer secret>", "<Place your API key>");
Transaction transaction = new Transaction();
List<AccountIdentifier> debitPartyList = new ArrayList<>();
List<AccountIdentifier> creditPartyList = new ArrayList<>();

debitPartyList.add(new AccountIdentifier("<identifier type>", "<identifier>"));
creditPartyList.add(new AccountIdentifier("<identifier type>", "<identifier>"));

transaction.setDebitParty(debitPartyList);
transaction.setCreditParty(creditPartyList);
transaction.setAmount("<amount>");
transaction.setCurrency("<currency>");

AgentServiceRequest agentServiceRequest = new AgentServiceRequest();
agentServiceRequest.setTransaction(transaction);
AsyncResponse sdkResponse = mmClient.addRequest(agentServiceRequest).createWithdrawalTransaction();

sdkResponse = mmClient.addRequest(agentServiceRequest).viewRequestState(sdkResponse.getServerCorrelationId());
String txnRef = sdkResponse.getObjectReference();

Reversal reversal = new Reversal();
reversal.setType("reversal");
agentServiceRequest.setReversal(reversal);
sdkResponse =  mmClient.addRequest(agentServiceRequest).addCallBack("<Place your callback URL>").createReversal(txnRef);

Additionally, if you want to use reversal details as JSON string, you can use the following code;

MMClient mmClient = new MMClient("<Place your consumer key>", "<Place your consumer secret>", "<Place your API key>");
AgentServiceRequest agentServiceRequest = new AgentServiceRequest();

String reversalJsonString = "{\"type\": \"reversal\"}";

agentServiceRequest.setReversal(reversalJsonString);

AsyncResponse sdkResponse =  mmClient.addRequest(agentServiceRequest).addCallBack("<Place your callback URL>").createReversal("<transaction reference>");

Response Example

{
  "serverCorrelationId": "0cef7251-bc7b-4437-8090-31c725484bbd",
  "status": "pending",
  "notificationMethod": "callback",
  "objectReference": "17825",
  "pollLimit": 100
}

NOTE

In asynchronous flows, a callback mechanism or polling mechanism is utilised to allow the client to determine the request's final state. Use the viewRequestState() function for the polling mechanism to receive the status of a request, and the viewTransaction() function to acquire the final representation of the Transaction object.