cancel.cgi

cancel.cgi cancels (voids and deletes) an authorization. The transaction is deleted and cannot be recreated. The system automatically sends an authorization reversal to the acquirer, releasing any reserved amounts to the cardholder's account if the acquirer and card issuer supports such reversal messages. Please notice that some acquirers and card issuers might not support reversal messages

This function requires an api user login for identification.

Function call

https://<username>:<password>@payment.architrade.com/cgi-adm/cancel.cgi

Example

Below is an example of a previously authorized payment cancelled using the recommended parameters for cancel.cgi.

<form method="post" action="https://login:password@payment.architrade.com/cgi-adm/cancel.cgi">
  <input type="hidden" name="merchant" value="98765432" />
  <input type="hidden" name="transact" value="12345678" />
  <input type="hidden" name="orderid" value="dibs_test_01">
  <input type="hidden" name="md5key" value="cfcd208495d565ef66e7dff9f98764da" />
  <input type="hidden" name="textreply" value="yes" />
</form>

Essential input parameters

 Parameter Description
md5key

This variable enables a MD5-key control of the values received by Nets. This control confirms that the values sent to Nets has not been tampered with during the transfer. See how MD5 is calculated here

merchant *

Shop identification. The Merchant ID appears in the e-mail received from Nets during registration with Nets or on your contract.

orderid * The shop’s order number for this particular puchase. It can be seen later when the payment is captured, and will in some instances appear on the customer’s bank statement (both numerals and letters may be used).
textreply *

Should be declared to receive the returned message in simple text format.

transact * The unique Nets identification number for the transaction. The transact is a as minimum 6-digit integer, e.g. transact=123456.

*: Mandatory parameters

Optional input parameters

Parameter Description
account

If multiple departments utilize the same Nets account, it may be practical to keep the transactions separate at Nets. An account name may be inserted in this field, to separate transactions at Nets.

To get an account, please contact the Nets sales department.

fullreply If this variable is set, all variables will be returned (as defined in the Nets admin).

 

Return parameters

Call accepted

If the cancel request is accepted, these parameters are returned:

Parameter Description
cardtype

Returns the type of payment the customer has used for a particular payment.

result Returns the result code for the call.
status

ACCEPTED/DECLINED

transact

The unique Nets identification number for the transaction. The transact is a as minimum 6-digit integer, e.g. transact=123456.

 

Return parameters

Call declined

If the cancel request is declined, these parameters are returned:

ParameterDescription
reason

Returns a reason for the rejection.

result

Returns the result code for the call.

status

ACCEPTED/DECLINED

 

Do you have a question or need help?
Follow us
Nets Online Payments

Oslo: +47 21 55 44 00
Stockholm: +46 (0)8-527 525 00
København: +45 7020 3077
Jyväskylä: + 358 010 80 40 40
Close menu