reauth.cgi - DIBS Technical Documentation

reauth.cgi

An authorised transaction is legally binding for a fixed number of days (e.g., the standard for Nets/Teller is 7 days). If the goods cannot be shipped to the customer within the fixed number of days (the goods may be out of stock), the transaction needs to be reauthorized before it can be captured. The function reauth.cgi offers a way to re-authorise transactions

If a payment is created through Swedbank (also known as BABS) the function reauth is not supported.
This means that if you have transaction where the authorization has expired, then you need to ask the cardholder to re-enter card details.
An authorization via Swedbank is normally valid for 30 days.

Merchants using the API: https://payment.architrade.com/cgi-bin/reauth.cgi will receive decline response

Merchants using renewal of authorization via Nets Admin, will be notified with a decline message.

Function call

https://payment.architrade.com/cgi-bin/reauth.cgi

Example

Below is an example of a transaction reauthorized using the recommended parameters for reauth.cgi.

<form method="post" action="https://payment.architrade.com/cgi-bin/reauth.cgi">
    <input name="merchant" value="98765432" type="hidden" />
    <input name="transact" value="789789789" type="hidden" />
    <input name="textreply" value="yes" type="hidden" />
</form>

Essential input parameters

Parameter	Description
merchant *	Shop identification. The Merchant ID appears in the e-mail received from Nets during registration with Nets or on your contract.
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 administration).

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 administration).

Return parameters

Auth accepted

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

Parameter	Description
?x=&y=...	All custom parameters defined by the shop are returned. Reserved words cannot be used as custom parameters. If several parameters are declared, it should be noted that browsers use various maximum lengths of query-strings (eg. 2083 characters for IE).
merchant, amount...	All parameters sent in the call are returned in the response if activated in the Nets Administration.
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

Auth declined

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

Parameter	Description
?x=&y=...	All custom parameters defined by the shop are returned. Reserved words cannot be used as custom parameters. If several parameters are declared, it should be noted that browsers use various maximum lengths of query-strings (eg. 2083 characters for IE).
merchant, amount...	All parameters sent in the call are returned in the response if activated in the Nets Admin.
reason	Returns the reason why the payment is declined. See the reason list here.
status	ACCEPTED/DECLINED