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 | 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. |
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. It is at minimum a 6-digit integer, e.g. transact=123456. If "split" is used, then "transact" is replaced by "transact1", "transact2", etc. |
| status | integer | Follow this link for a list of possible status. |
| currency | integer | Currency code of the transfer in the ISO4217 form, e.g. 208 for DKK - 752 for SEK (see other ISO4217 currency codes). |
| [amount] | integer - Minimum value of 1 - maximum value of 2147483647 | Amount to be transferred. The amount is given in the smallest unit, e.g. cents 100 = USD 1. |
| [approvalcode] | string. Max 6 characters | 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). |
| [fee] | integer | Transactions that have a fee amount return this. Like amount it is in the smallest unit. |
| [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. |
| [orderid] | string | The shop's original order identification number is returned. |