transimg.cgi

 

Description

transimg.cgi is used for checking the current status of a transaction. The response is one of three icons indicating the status. The status icon can be embedded in ones HTML code using an IMG tag, which src calls transimg.cgi (see the example for details).


Function call

 http://payment.architrade.com/cgi-bin/transimg.cgi


Input parameters

The function transstat.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.

amount

Amount to be transferred. The amount must be given in smallest possible unit, e.g. cents 100 = USD 1.

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, (see other ISO4217 currency codes).

[account]

If the account parameter was initially used when the payment was made it should also be used here.

 

Return parameters

The function transimg.cgi returns a traffic-light icon where:

A red light means the transaction was not found or was not authorised.

A yellow light indicates that the transaction is found, but needs to be re-authorised/confirmed.

A green light means that the transaction was found, and is either captured or ready to be captured.

 

Notes

An alternative to transimg.cgi is the function transstat.cgi , which returns a number indicating the status of a specific transaction, rather than an icon.


Example

<IMG xsrc="payment.architrade.com/cgi-bin/transimg.cgi&
merchant=4123456&currency=208&amount=29900>