reauth.cgi
Please note, that reauth.cgi does not work for the Danish cards Dankort and VISA-Dankort.
Description
An authorised transaction is legally binding for a fixed number of days (e.g., the standard for PBS 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 re-authorised before it can be captured. Please note, that it is important to re-authorise the transaction before shipping the goods, since the credit card may have been stolen or expired in the meantime. Under normal circumstances the re-authorisation process is handled through the DIBS administration interface. However, the function reauth.cgi offers another way to re-authorise transactions.
Usage
The standard work flow for reauth.cgi is:
- A set of parameters are posted to: https://payment.architrade.com/cgi-bin/reauth.cgi
- The DIBS server processes the information
- A response is sent to the script that originally posted the request to the DIBS servers
Function call
https://payment.architrade.com/cgi-bin/reauth.cgi
Input parameters
The function reauth.cgi accepts the following input parameters:
Parameter | Description |
| merchant | Shop identification. The Merchant number appears in the e-mail received from DIBS during registration with DIBS or on your contract. Your merchant number can also be retreived by contacting your respective DIBS support department below. Denmark Norway Sweden |
| transact | The unique DIBS identification number for the transaction you want to capture. The transact is returned from a successful authorisation, and is a as minimum 6-digit integer , e.g. transact=123456. |
| textreply | If this variable is set to be true (e.g. textreply=yes), then the DIBS system returns its answer in simple text format. If you are not using the standard DIBS payment window, e.g. using server-to-server requests, this significantly simplifies parsing the answer from DIBS. You may use either port 80 or port 20080. |
| [fullreply] | If this variable is set, all variables will be returned (as defined in the DIBS admin). Note: This only works when used together with textreply. |
| [account] | If multiple departments utilize the company’s acquirer agreement with the acquirer, it may prove practical to keep the transactions separate at DIBS. An ”account number” may be inserted in this field, so as to separate transactions at DIBS. |
Return parameters
The return parameters depend on the result of the reauthorisation. If the transaction was accepted, then the return parameters are:
Parameter | Type | Description |
| transact | integer | All transactions are given a unique DIBS identification number. It is at minimum a 6-digit integer, e.g. transact=123456. If "split" is used, then "transact" is replaced by "transact1", "transact2", etc. |
| status | string | ACCEPTED/DECLINED |
| [?x= | optional | Parameters sent to reauth.cgi as part of the accepturl are returned. |
| All values | not a parameter | In the DIBS administration interface it is possible to enable the return of all parameters sent to reauth.cgi, except credit card details. |
If the reauthorisation was not accepted, the return parameteres are:
Parameter | Type | Description |
| status | string | ACCEPTED/DECLINED |
| reason | integer | If the transaction is rejected, it returns with a reason for the rejection. Please refer to error codes for a list of possible values. |
| [?x= | optional | Parameters sent to reauth.cgi as part of the accepturl are returned. |
| All values | not a parameter | In the DIBS administration interface it is possible to enable the return of all parameters sent to reauth.cgi, except credit card details. |
Example
|
<form method="post" action="https://payment.architrade.com/cgi-bin/reauth.cgi"> |