The Transaction System is used in most cases where the merchant has a user database or content that does not require ClickandBuy to manage access to the content (e.g. a shopping cart).

Downloads

Complete manual

Example scripts for download

Example PHP Transaction Script (ZIP-File)

Example ASP Transaction Script (ZIP-File)

Example PHP isExternalBDRIDCommitted (Second Confirmation) script (ZIP-File)

Example ASP isExternalBDRIDCommitted (Second Confirmation) script (Zip-File)

The transaction system works thus:

• You are first required to host a transaction processing script on your web server. The target URL of this script needs then to be set against a ClickandBuy Transaction link in your merchant account service area. An example script can be downloaded above.
• At the point of sales the customer is to be redirected to your ClickandBuy Transaction URL to confirm the payment. You can retrieve the code to add your ClickandBuy Transaction URL to your website by clicking on [-> Add link] next to your configured link in your Link List. This URL must include a query string including at least the parameters ‘price’ and ‘externalBDRID’ (your unique billing reference number)
• When the customer chooses to confirm payment we execute the target URL of your Transaction Link in the ClickandBuy web proxy and return purchase confirmation data to you in the Server Header and query string
• Your target URL must evaluate this data and order ClickandBuy to commit or reject the transaction
• Transaction committal/rejection is achieved with an absolute redirect away from the ClickandBuy web proxy to a landing page hosted on your website
• This redirect must include a Success String parameter ‘result=success’ which is used as a server handshake to commit the transaction and charge the customer. Alternatively Success String ‘result=error’ can be included to reject and discard the transaction in cases where bad/missing data is returned
• When result=success is communicated to commit the transaction, your customer landing page should make a web service call to SOAP method isExternalBDRIDCommitted as a second handshake to ensure committal of the transaction before granting the customer content access. This is a real-time communication that safeguards against any timeout that may have occurred in the first handshake; it ensures no discrepancy between your transaction records and those recorded on ClickandBuy.

Troubleshooting:

”Transaction error, no redirect location specified”

This indicates a fault with your hosted transaction script. It can mean either:

• The ClickandBuy web proxy does not have access permission to execute your target URL. Check your firewall or directory security settings.
• The target URL script fails at some point (syntax error or db access fault)
• The script writes html output to the browser. Please ensure your script contains no PHP echo or ASP Response.Write commands.
• The final redirect specified is not to an absolute URL on your server.
• The script is not located at the URL defined for that link.