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).
https://login:password@payment.architrade.com/cgi-adm/payinfo.cgi
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. |
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. |