Split auth is the possibility of creating a number of individual transactions on amounts specified in the call to DIBS. This can be done either through FlexWin or auth.cgi.
A simple example would be:
<form method="post" action="https://payment.architrade.com/paymentweb/start.action" accept-charset="utf-8"> <input type="hidden" name="merchant" value="*YOUR MERCHANT ID*" /> <input type="hidden" name="accepturl" value="https://domain.com/acceptpage.html" /> <input type="hidden" name="split" value="2" /> <input type="hidden" name="amount1" value="200" /> <input type="hidden" name="amount2" value="300" /> <input type="hidden" name="currency" value="208" /> <input type="hidden" name="orderid" value="DIBSTEST"/> </form>
As seen, the two amounts are specified, one for each of the split payments. Furthermore, the 'split' parameter is sent with the value being the number of split amounts, to indicate that this is a split payment rather than a normal payment.
If the payments are accepted, the response will contain a transaction ID for each of the created sub transactions. The transaction ID's can then be captured individually.
An example of the response would be:
approvalcode: 123456 paytype: VISA status: accepted transact1: 1250819537 transact2: 1250819539
Split on capture is a feature enabling the possibility of capturing a transaction through several smaller captures, until the full amount has been reached. To use this feature, a normal authorization is made. If successful, the transaction will be shown in the Administration with an 'S' after the transaction ID:
This feature is especially useful if some of the sold goods will be delivered before others (e.g. if some are not in stock at the time of the purchase).
When capturing a split capture transaction, it can be done either by clicking Split Capture in the Administration and chosing the amount to be captured for each sub transaction, or by calling capture.cgi with the desired amount and the parameter 'splitpay'. If at some point, the remaining amount on the split capture transaction should not be captured, the payment should be closed either through the Administration by clicking Close or using the 'close' parameter for capture.cgi. The status of a split payment can also be changed using the API function splitpay_changestatus.cgi. For each of the sub-captures, a transaction ID will be created, and these ID's will be returned by capture.cgi and will be visible in the Administration when clicking on the split transaction.
Due to the way split payments are handled by VISA and Mastercard, only 1.00 unit of currency will be cleared in the initial authorization. Successive captures will automatically be carried out as a “Split Payment” where the sub-transaction authorization and capture is carried out in one call. This means that the merchant will receive the response from both requests at the time of shipment when the products are ready to be sent, and the shop should therefore always capture the orders just before the item is sent to ensure that the customer has the required balance.
- Currently Split capture is only supported by the following cardtypes Visa, Mastercard, Visa-dankort, Dankort and only through the acquirer NETS/PBS.
- At the moment merchants must contact the DIBS Support in order to enable this feature. When enabled, all transactions will be affected by the feature.