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

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 DIBS during registration with DIBS or on your contract.
textreply *	Should be declared to receive the returned message in simple text format.
transact *	The unique DIBS 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 DIBS account, it may be practical to keep the transactions separate at DIBS. An account name may be inserted in this field, to separate transactions at DIBS. To get an account, please contact the DIBS sales department.
fullreply	If this variable is set, all variables will be returned (as defined in the DIBS administration).

Parameter

Description

account

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

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

fullreply

If this variable is set, all variables will be returned (as defined in the DIBS 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 DIBS Administration.
status	ACCEPTED/DECLINED
transact	The unique DIBS 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 DIBS Admin.
reason	Returns the reason why the payment is declined. See the reason list here.
status	ACCEPTED/DECLINED