changestatus.cgi

The purpose of changestatus.cgi is to allow changing the status of a specific transaction on the DIBS server, without using the DIBS administration interface

This function requires an api user login for identification.

Function call

https://<username>:<password>@payment.architrade.com/cgi-adm/changestatus.cgi

Information

The transaction may have the following status:

  • Declined: the transaction failed to be captured.
  • Captured: the transaction was captured.
  • Matched: the transaction was matched against an ERP system.
  • Pending: the transaction is ready to be captured.

For obvious reasons, it is not possible to change the status of an already captured transaction in order to allow it to be captured again. Transactions may change status in the following manner: 

  • Captured —> Matched
  • Matched —> Captured
  • Capture Pending/Declined —> New
  • Capture Pending/Declined —> Cancelled
  • Capture Pending/Declined —> Captured

Example

Below is an example of a changestatus.cgi request in HTML:

<form method="post" action="https://apiusername:apipassword@payment.architrade.com/cgi-adm/changestatus.cgi">
	<input type="hidden" name="merchant" value="90089353">
	<input type="hidden" name="amount" value="100">
	<input type="hidden" name="transact" value="1254345076">
	<input type="hidden" name="action" value="matched">
	<input type="hidden" name="force" value="yes">
	<input type="hidden" name="textreply" Value="yes">
</form>
Response:
status=ACCEPTED&transact=1254345076

Essential input parameters

Parameter Description
action * Action must take on either: “new”, “matched”, “canceled”, or “captured” depending on the status you want the transaction to have afterwards.
amount *

The smallest unit of an amount in the selected currency, following ISO4217 (see the currency list here).

Example:

Smallest unit for EUR is "cent" thus setting 'amount="150"' leads to the amount being 1,50 EUR
Smallest unit for JPY is "yen" thus setting 'amount="150"' leads to the amount being 150 JPY
force Use this to change status from either Pending or Declined to New, Cancelled or Captured (see below for more information).
merchant *

Shop identification. The Merchant ID appears in the e-mail received from DIBS during registration with DIBS or on your contract.

textreply * Should be declared to receive the returned message in simple text format.
transact *

The unique DIBS identification number for the transaction. The transact is a as minimum 6-digit integer, e.g. transact=123456.

*: Mandatory parameters

Optional input parameters

ParameterDescription
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.

fullreply

If this variable is set, all variables will be returned (as defined in the DIBS admin).

 

Return parameters

Changed status accepted

ParameterDescription

status

ACCEPTED/DECLINED

transact

The unique DIBS identification number for the transaction. The transact is a as minimum 6-digit integer, e.g. transact=123456.

 

Return parameters

Changed status declined

If the change status request is declined, the following parameters are returned:

ParameterDescription
message

If declined a reason is returned in this parameter.

status

ACCEPTED/DECLINED

 

Do you have a question or need help?
Follow us
DIBS Payment Services
Stockholm +46 (0)8-527 525 00
Göteborg +46 031-600 800
København +45 7020 3077
Oslo +47 21 55 44 00