Report Purchase Cancellation

This API is used to cancel a b-buzzy transaction.

This report to B-buzzy is optional, a purchase cancellation can also be done through the transaction page on B-buzzy.com .




If you choose to use this API you must first produce a 'secret' key that would be used to identify your request.

The 'secret' can be produced here.

Note that the 'secret' is used to identify you, so you should keep it safe and on a none public area on your server.


The purchase cancellation is done by an https request to this URL: https://b-buzzy.com/API/cancelPurchase/index.php with the following POST NVP parameters:

Parameter name	Details
sellerId	The Id provided by B-buzzy
sellerSecret	Your 'secret'
tranIdToCancel	Your transaction id to be canceled. This parameter must match the transaction id reported on 'bbuzzy_transactionId' parameter on the 'after purchase page'. For more details about this parameter see the 'after purchase page' API.
allProductsOnTransaction	Put "YES" on this parameter if you wish to cancel all of the products on the transaction reported on the parmeter "tranIdToCancel". If you report "YES" on this parameter, than you do not need to report the parameter "sellerProductId".
sellerProductId	Your product id to be canceled. This parameter must match the product id reported on 'bbuzzy_sellerProductId' parameter on the 'after purchase page'. For more details about this parameter see the 'after purchase page' API.
cancellationReason	The reason for the cancellation. Must be one of the following values (without the quote): 1. 'purchase_cancellation_by_user' 2. 'purchase_cancellation_by_seller' 3. 'fraud_suspicion' 4. 'other'
cancelRemark	Your remark to the cancellation. Must be up to 300 charecters.

* All of the parameters passed must be URL encoded.


The response for the request is a XML file as follows:

Node name	Details
fieldsData	Holds all the names and values the parameters on your request. For each field (besides "sellerSecret" for security), a node of 'name' and 'value' will be provided.
product	Holds the response data of each of the products you try to cancel.
productId	Holds the "productId" of the product.
requestMessage	Holds the message result of the request. If the cancellation is successful than the value will be 'cancellation_saved'. Else, the value will be 'cancellation_not_saved'.
errors	If the cancellation is not successful than this node will provide the error messages for each field with error. For each field, a node of 'fieldName' and 'fieldErrorMessage' will be provided.

Here is a sample file that illustrates the structure of the XML response: