splitpay_changestatus.cgi

Description

The script changes the status of a Split Payment from open to closed – or vice versa.

Function call

https://user:passwd@payment.architrade.com/cgi-adm/splitpay_changestatus.cgi.
Username and password from the API-user created in the Dibs administration is required in the URL.

Input parameters

splitpay_changestatus.cgi accepts the following parameters:

Parameter

Description

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

Your merchant number can also be retreived by contacting your respective DIBS support department below.
Denmark
Norway
Sweden

transactThe 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.
actionThe status to assign to the Split Payment base transaction.
Allowed values "open" or "close"
 

Return parameters

The function splitpay_changestatus.cgi returns the following response parameters:

Parameter

Description

resultValues returned ACCEPTED or DECLINED.
[reason]In case of status=DECLINED, the reason parameter returns an integer error code. Please refer to the list of error codes.
[message]Textual message describing the error:

Possible messages if "reason=6"
Status doesn't allow open
Status doesn't allow close

Possible messages if "reason=8"
Error in argument action
Error in argument merchant
Error in argument transaction
Unknown merchant (merchantid)
Authentication error
Authorization error
Unknown transaction id (transactionid)

Possible messages if "reason=12"
Unknown error

Example

This example shows the call to splitpay_changestatus.cgi in the form of a simplified standard HTML form:

<form action="https://user:passwd@payment.architrade.com/cgi-adm/splitpay_changestatus.cgi" method=POST>
    <input type="hidden" name="merchant" value="12345678">
    <input type="hidden" name="transact" value="11111111">
    <input type="hidden" name="action" value="close">    
</form>

 
CMS - Content Management System By SiteLoom