refund.cgi

The function refund.cgi  is used for refunding a previously captured transaction to the cardholders account. Keep in mind that only some acquirers support refunds

If you have many refunds related to COVID-19, it will be possible to manually refund transactions in Nets admin or create a script that runs all the transactions through and refunds in that way.

Here is a quick guide how to bulk refund in Nets admin


This function requires an api user login for identification.

Function call

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

Example

Below is an example of a payment refunded using the recommended parameters for refund.cgi.

<form method="post" action="https://login:password@payment.architrade.com/cgi-adm/refund.cgi">
  <input type="hidden" name="merchant" value="12345678">
  <input type="hidden" name="transact" value="11111111">
  <input type="hidden" name="amount" value="2000">
  <input type="hidden" name="currency" value="208">
  <input type="hidden" name="orderid" value="11223344">
  <input type="hidden" name="md5key" value="cfcd208495d565ef66e7dff9f98764da">
  <input type="hidden" name="textreply" value="yes">
</form>

Essential input parameters

Parameter Description
amount *

The smallest unit of an amount in the selected currency, following ISO4217 (see the currency list here).

Example:

Smallest unit for EUR is "cent" thus setting 'amount="150"' leads to the amount being 1,50 EUR
Smallest unit for JPY is "yen" thus setting 'amount="150"' leads to the amount being 150 JPY
currency *

Currency is defined using the ISO4217 standard (see the currency list here). Both numeric and upper case letter codes are accepted.

Example:

currency="SEK"
currency="752"
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

Note: When using MD5, the order id must be unique.

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 purchase. It can be seen later when 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

ParameterDescription

result

Returns the result code for the call.

 

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