transinfo.cgi
Description
The function transinfo.cgi is used for retrieving the status and other transaction information for a specific transaction.
Function call
https://payment.architrade.com/cgi-bin/transinfo.cgi
Input parameters
The function transinfo.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 |
| amount | The smallest unit of an amount, eg. cent for EUR , øre for Danish crowns, Example: 1,00 EUR = 100 or 1,50 EUR =150 |
| orderId | The shop’s order number for this particular puchase. 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). |
| currency | Currency specification as indicated in ISO4217 where the EUR is no. 978. Either the numeric or alphabetic code is accepted. Also see our list of currencies. |
| [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 function transinfo.cgi returns the following response parameters:
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 | integer | The status of the transaction. 0: The transaction was found and is declined. 1: The transaction is either ready to be captured 2: The transactions is "Captured" 3: The transaction was found and is "INSERTED" (no reply from Acquire) |
| [approvalcode] | string. Max 6 characters | For status=2 and status=5 only, the approvalcode contains the acquirer authorisation code. The parameter approvalcode is returned only when the credit card was scanned (track2 is part of the information). |
| [actioncode] | string | This is the action code returned by the acquirer. |
Example
The following example shows a standard HTML form for calling transinfo.cgi:
<FORM action="https://payment.architrade.com/cgi-bin/transinfo.cgi" method=POST><input type="text" name="merchant" value="1234567">
<input type="text" name="orderid" value="b34xyz">
<input type="text" name="currency" value="208">
<input type="text" name="amount" value="123300">
</FORM>