confirmtransact.cgi - DIBS Technical Documentation

confirmtransact.cgi

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 accepturl can be called directly, an order in your web-shop could be made without a customer 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

Function call

https://payment.architrade.com/cgi-bin/confirmtransact.cgi

Example

Below is an example of a call to confirmtransact.cgi.

<form method="post" action="https://payment.architrade.com/cgi-bin/confirmtransact.cgi">
  <input type="hidden" name="merchant" value="123456789">
  <input type="hidden" name="transact" value="987654321">
  <input type="hidden" name="orderid" value="sdf786e4jsdf82">
  <input type="hidden" name="currency" value="208">
</form>

Input parameters

Parameters	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.
currency *	Currency is defined using the ISO4217 standard (see the currency list here). Only numeric codes are accepted. Example: currency="752"
merchant *	Shop identification. The Merchant ID appears in the e-mail received from DIBS during registration with DIBS or on your contract.
orderíd *	The shop’s order number for this particular purchase. It can be seen later when a 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. The transact is a as minimum 6-digit integer, e.g. transact=123456.

*: Mandatory parameters

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.