Skip to content

Process Reversal

POST transaction/process_reversal

Description URL Response Format Request Method Authentication
Issue a reversal for a transaction that was previously voided/chargedback https://domain/api/transaction/process_reversal JSON POST HTTP headers

Parameters

Name Description Type Required
transaction_hash Click_hash/transaction_hash of the transaction you want to reverse string no
click_hash Click_hash/transaction_hash of the transaction you want to reverse string no
orderid Transaction identifier sent on conversion (orderid) you want to reverse string no
transactionid Trackfinity generated transaction identifier you want to reverse string no
trans_custom1 Custom value to record with a transaction. -1 is a reserved value and should not be used string no
trans_custom2 Custom value to record with a transaction. -1 is a reserved value and should not be used string no
trans_custom3 Custom value to record with a transaction. -1 is a reserved value and should not be used string no
trans_custom4 Custom value to record with a transaction. -1 is a reserved value and should not be used string no
trans_custom5 Custom value to record with a transaction. -1 is a reserved value and should not be used string no

Example Request

POST

https://domain.com/api/transaction/process_reversal

Response:

Success
{
   "result": "success",
   "message": "*success*"
}

Failure
{
   "result": "error",
   "message": "Missing required flag (reverse)."
}

Example Code

php

<?php
$curl = curl_init();

$data = array(
    'reverse' => TRUE,
    'transaction_hash' => '156097c947ece92.38318951',
);
$url = 'http://domain/api/transaction/process_reversal';
$headers = array(
    'api-key: 44b5498dbcb481a0d00b404c0169af62',
    'api-username: productsupport'
);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_URL, $url);

$resp = curl_exec($curl);
//dumps an associative array representation of the json response
$output = json_decode($resp, true);
if($output !== NULL) {
    //json was valid. Dump the decoded array
    print_r($output);
}
else {
    //invalid json, just dump the raw response
    print_r($resp);
}
// Close request to clear up some resources
curl_close($curl);
?>