payinfo.cgi

 

Description

The function payinfo.cgi is used for retrieving information regarding a specific transaction. For security reasons the function call requires basic authentication using the DIBS administration interface login and password (create an API-user).

 

Function call

https://login:password@payment.architrade.com/cgi-adm/payinfo.cgi

 

Input parameters

The function payinfo.cgi accepts the following input parameters:

Parameter

Description

transact

All transactions are given a unique DIBS identification number, it is an integer of minimum 6 digits, e.g. transact=123456.

 

Return parameters

The function payinfo.cgi returns the following response parameters:

Parameter

Type

Description

transact

integer

All transactions are given a unique DIBS identification number, which is an integer of 6-digits minimum, e.g. transact=123456.

status

integer

The status of the transaction, where a value of 2 means "new", 1 means "rejected", and 5 means "approved".

amount

integer

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

currency

integer

Currency code of the transfer in the ISO4217 form, e.g. 208 for DKK (see other ISO4217 currency codes).

[fee]

integer

Transactions that have a fee amount return this. Like amount it is in the smallest unit.

[orderid]

string

The shops order number, which may contain a maximum of 50 characters.

[approvalcode]

string

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.

[batch]

integer

When the transaction is captured by a batch job, this parameter contains the ID of the batch job.