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 | The merchant parameter is the shops DIBS identification number. The merchant number is available in the order confirmation email and is a 7-digit integer. |
transact | All transactions are given a unique DIBS identification number, it is a as minimum 6-digit integer , e.g. transact=123456. |
orderid | The shops order number, which may contain a maximum of 50 characters. |
currency | Currency code of the transfer in the ISO4217 form, e.g. 208 for DKK (see other ISO4217 currency codes ). |
[account] | If several departments in a company use the same acquirer contract it may be beneficial to keep track of the transactions by department. Setting the account parameter enables separation of the transaction by department. |
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="<link https://payment.architrade.com/cgi-bin/confirmtransact.cgi>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>
