confirmtransact.cgi
Description
confirmtransact.cgi is used for confirming that a particular transaction was successfully registered on the DIBS server, and the payment authorised. This may seem superfluous, however, as the URL of the accepturl and more-so the source of the accepturl is publicly available, criminals may be tempted to make a call to the accepturl directly, and this way register an order in your web-shop without going trough the process of authorising an actual credit card payment. An alternative to ensure that the a transaction has not been tampered with, is to use the MD5-key control .
Usage
confirmtransact.cgi is used by sending a post request to:
- https://payment.architrade.com/cgi-bin/confirmtransact.cgi
The response is automatically sent as simple text reply.
Function call
https://login:password@payment.architrade.com/cgi-bin/confirmtransact.cgi
Input parameters
The function confirmtransact.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 |
| 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). |
| 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. |
| 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
If the transaction is registered on the DIBS server, the call to confirmtransact.cgi will return the amount of the transaction (in the smallest possible unit). If the transaction is not registered on the DIBS server, confirmtransact.cgi will return 0.
Example
<FORM action="https://payment.architrade.com/cgi-bin/confirmtransact.cgi" method=POST>
<input type="hidden" name="merchant" value="12345678">
<input type="hidden" name="transact" value="400111">
<input type="hidden" name="orderid" value="sdf786e4jsdf82">
<input type="hidden" name="currency" value="208">
</FORM>