Cancel Payment

curl --request POST \
     --url https://sand-api.monoova.com/au/card/ccm/CreditCardTransaction/cancel \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "clientTransactionUniqueReference": "PAY-20261013-0001",
     "reason": "Customer cancelled the order"
     }'

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var raw = JSON.stringify({
   "clientTransactionUniqueReference": "PAY-20261013-0001",
   "reason": "Customer cancelled the order"
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://sand-api.monoova.com/au/card/ccm/CreditCardTransaction/cancel", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

require "uri"
require "json"
require "net/http"

url = URI("https://sand-api.monoova.com/au/card/ccm/CreditCardTransaction/cancel")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "clientTransactionUniqueReference": "PAY-20261013-0001",
   "reason": "Customer cancelled the order"
})

response = https.request(request)
puts response.read_body

import requests
import json

url = "https://sand-api.monoova.com/au/card/ccm/CreditCardTransaction/cancel"

payload = json.dumps({
   "clientTransactionUniqueReference": "PAY-20261013-0001",
   "reason": "Customer cancelled the order"
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

// Success. The cancellation request was processed; check status for the outcome. The API can also return this response with HTTP status 201 Created.
{
  "traceId": "71170aca-7ed5-5045-b317-39f21a1d985e",
  "clientTransactionUniqueReference": "PAY-20261013-0001",
  "status": "Cancelled",
  "statusReasonCode": "05",
  "statusReasonDescription": "Do not honour"
}

// Bad request. The request failed validation - for example clientTransactionUniqueReference is missing or invalid, or the payment cannot be cancelled in its current status.
{
  "traceId": "71170aca-7ed5-5045-b317-39f21a1d985e",
  "errors": [
    {
      "errorCode": "CCM_VALIDATION_ERROR",
      "errorMessage": "Error validating request message - amount.currencyAmount required",
      "sourceErrorCode": "DECLINED",
      "sourceErrorMessage": "Transaction declined by issuer"
    }
  ]
}

// Unauthorized. The bearer token is missing, malformed or expired. Generate a new bearer token and retry the request.

// Forbidden. Your mAccount is not permitted to perform this operation - for example card payments are not enabled for your account.
{
  "traceId": "71170aca-7ed5-5045-b317-39f21a1d985e",
  "errors": [
    {
      "errorCode": "CCM_VALIDATION_ERROR",
      "errorMessage": "Error validating request message - amount.currencyAmount required",
      "sourceErrorCode": "DECLINED",
      "sourceErrorMessage": "Transaction declined by issuer"
    }
  ]
}

// Not found. No payment matches clientTransactionUniqueReference for your mAccount.
{
  "traceId": "71170aca-7ed5-5045-b317-39f21a1d985e",
  "errors": [
    {
      "errorCode": "CCM_VALIDATION_ERROR",
      "errorMessage": "Error validating request message - amount.currencyAmount required",
      "sourceErrorCode": "DECLINED",
      "sourceErrorMessage": "Transaction declined by issuer"
    }
  ]
}

// Internal server error. An unexpected condition prevented Monoova from completing the request. Retry the request and contact Monoova support if the error persists.
{
  "traceId": "71170aca-7ed5-5045-b317-39f21a1d985e",
  "errors": [
    {
      "errorCode": "CCM_VALIDATION_ERROR",
      "errorMessage": "Error validating request message - amount.currencyAmount required",
      "sourceErrorCode": "DECLINED",
      "sourceErrorMessage": "Transaction declined by issuer"
    }
  ]
}

// Bad gateway. A downstream service returned an invalid response, so the outcome of the request is unknown. Check the result with Get Transaction By Id before you retry.

// Gateway timeout. A downstream service did not respond in time, so the outcome of the request is unknown. Check the result with Get Transaction By Id before you retry.
{
  "traceId": "71170aca-7ed5-5045-b317-39f21a1d985e",
  "errors": [
    {
      "errorCode": "CCM_VALIDATION_ERROR",
      "errorMessage": "Error validating request message - amount.currencyAmount required",
      "sourceErrorCode": "DECLINED",
      "sourceErrorMessage": "Transaction declined by issuer"
    }
  ]
}