This function requires an api user login for identification.
Below is an example of a previously authorized payment cancelled using the recommended parameters for cancel.cgi.
<form method="post" action="https://login:firstname.lastname@example.org/cgi-adm/cancel.cgi"> <input type="hidden" name="merchant" value="98765432" /> <input type="hidden" name="transact" value="12345678" /> <input type="hidden" name="orderid" value="dibs_test_01"> <input type="hidden" name="md5key" value="cfcd208495d565ef66e7dff9f98764da" /> <input type="hidden" name="textreply" value="yes" /> </form>
Essential input parameters
This variable enables a MD5-key control of the values received by DIBS. This control confirms that the values sent to DIBS has not been tampered with during the transfer. See how MD5 is calculated here
Shop identification. The Merchant ID appears in the e-mail received from DIBS during registration with DIBS or on your contract.
|orderid *||The shop’s order number for this particular puchase. It can be seen later when the payment is captured, and will in some instances appear on the customer’s bank statement (both numerals and letters may be used).|
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
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).|
If the cancel request is accepted, these parameters are returned:
Returns the type of payment the customer has used for a particular payment.
|result||Returns the result code for the call.|
The unique DIBS identification number for the transaction. The transact is a as minimum 6-digit integer, e.g. transact=123456.
If the cancel request is declined, these parameters are returned:
Returns a reason for the rejection.
Returns the result code for the call.