WebSphere Commerce EnterpriseWebSphere Commerce Professional

BidSubmit URL

Validates input from the BidCreateForm command or the BidUpdateForm command.

Validates input from the BidCreateForm command or the BidUpdateForm command. If the required parameter values are valid, a new row is created in the BID table. If an existing bid is updated, a new row is created in the BIDLOG table to reflect the existing bid data. The bid message field in this new BIDLOG row is set to Superseded.

URL structure

http:// host_name/path/
The fully qualified name of your WebSphere Commerce Server and the configuration path.

Parameter values

aucrfn
Required: The reference number of the auction for which a bid is being submitted.
bidrfn
Required: The reference number of the new bid that is being submitted.
bidquant
Required: The quantity of products being bid for.
bidval
Required: The price the bidder is willing to pay for each product.
bidauthflg
Required: The authorization flag. Authorizes a deduction from the specified credit card. The only value currently accepted is on (enabled).
bidshprfn
Required: The shipping address reference number.
bidbillrfn
Required: The billing address reference number.
redirecturl
Required: The URL that is called when the command completes successfully.
bidshpmod
Required: The shipping mode reference number.
bidquantflg
The partial quantity flag. By default, the full quantity is required unless specified otherwise.
bidcreatetime
The time the bid or autobid was created. The default is set to the current system (server) time.
bid_action
Required: The action to be taken by the bid: create or update.
paymentPolicyString
Required: String which contains the following payment information:
policyId
The ID of payment policy.
cardBrand
The name of payment card brand.
cardNumber
The payment card number.
cardExpiryMonth
The month after which the payment card expires.
cardExpiryYear
The year after which the payment card expires.
policyChange
Required: The payment selection index.

Example

This example submits a new bid:

http://myhostname/webapp/wcs/stores/servlet/BidSubmit?paymentPolicyString=policyId=200;  
cardBrand=Brand2;cardNumber=111111111111;cardExpiryMonth=01;cardExpiryYear=2004
&PolicyChange=0&redirecturl=AuctionAckView&aucrfn=10001&bid_action=create
&bidrfn=B2-104743514582-110847&bidval=999&bidquant=1&bidquantflg=On&bidauthflg=On
&bidbillrfn=10051&bidshprfn=10051&bidshpmod=10001

Behavior

  • Looks up the auction based on the specified auction reference number and verifies that the status is Current.
  • Checks that the customer-specified bid price meets best bid value requirements.
  • For Dutch auctions, verifies that the requested number of items is greater than or equal to the current quantity on auction.
  • Calls the CheckBidderQualification task command to determine whether the customer is authorized to bid in this auction. The task command checks that the customer is registered.
  • Calls the CheckBidderStatus task command to ensure the customer has viewed the auction rules.
  • If called from the BidUpdateForm command, verifies that the auction type is not Dutch.
  • Calls the CheckBidUpdateAuthorization task command to determine if the auction rules allow bid update and if the customer is authorized to update it. The bid owner ID must match the customer ID.
  • Calls the CheckGenBidRef task command to validate the bid reference number.
  • If the auction type is not Dutch, calls the CheckBidControl task command to determine if the bidding rules were followed.
  • Calls the CheckCCNumber command to validate the credit card number and expiration date.
  • Calls the DataCrypt command to encrypt the credit card number.
  • Calls the AddressAccessBean and AddressBookAccessBean to validate the shipping and billing addresses. Calls the ShipModeAccessBean to validate the shipping mode reference number.
  • If an existing bid is being updated, creates a new row in the BIDLOG table with the same field values as in the existing bid and sets the bid message field to Superseded. For a new bid, creates a new row in the BID table and sets its fields based on the user input data.
  • For Open Cry and Sealed Bid auctions, calls the DoDepositPayment task command to record the deposit in the BIDPAYMENT table. Note that the deposit is only recorded in this table; it is not collected or applied to an order. You must implement your own overridable task in order to process the deposit.
  • Calls the MemberAuctionRelationAccessBean to add the auction to the auction gallery, if it is not already present.
  • Redirects to the specified URL.

Exception Conditions

  • An incorrect auction reference number results in an incorrect auction key exception.
  • An auction status other than Current results in an auction not current exception.
  • An unqualified bidder results in an unregistered user exception.