/Checkout/Hold/{OrderID} POST

Hold an Item for purchase prior to processing a payment.

URL
/Checkout/Hold/{OrderID}
Verb
Post

Headers

Header Data Type Valid Values Required Description
Content-Type string application/json YES The format your data will be sent to our site.
X-DevKey string string YES The devkey assigned to the developer.
X-AccessToken string string YES The token acquired from a POST to Users/AccessToken.

Input

NOTE: Variables to place in the body of the request.

Parameter Data Type Valid Values Description
BuyerID integer positive # The GunBroker.com User ID for the Buyer of the Item.
PaymentAmount decimal positive # The total payable on the Order.

Output

All authorized calls to this endpoint will result in a 200 OK reponse. The body of the response contains a ResponseCode that will tell you the result of your request

Parameter Data Type Valid Values Description
ResponseCode string 000 - Item Held
001 - Item is no longer available
002 - Item is no longer available for Buy Now
003 - Order not found
004 - Invalid Order status
005 - Order does not belong to the Buyer
006 - Requested quantity is no longer available
007 - Specified Payment Amount is not valid
008 - Checkout complete
009 - Payment failed, hold released
010 - Checkout complete payment in process
011 - Chargeback has been recorded
012 - Chargeback has been reversed
013 - Chargeback already exists on Order
014 - Order has been updated to Payment Received
015 - Order has been updated to Pending Payment Received
016 - Chargeback does not exist on Order
017 - TransactionID is required for Approved payments.
999 - An unexpected error has occurred. Please try again.
Response code tells you the result of your request.
Message string string Describes either the action taken or error encountered.
ExtraInfo string string Optional text that provides relevant information for an error while processing the request.