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 invalid auction reference number results in an invalid 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.

Related concepts

Auctions

Related tasks

Enabling auctions

Related reference

AutoBidCreateForm URL
AutoBidSubmit URL
AutoBidUpdateForm URL
AutoBidDelete URL
BidCreateForm URL
BidDelete URL
BidUpdateForm URL
CloseBidding URL
DeleteMail URL
DisplayAuctionRules URL
DisplayMessage URL
DisplayAuctionItem URL
DoAuctionNotify URL
FinalizeAuction URL
GalleryDelete URL
ModifyForumMessageList URL
MonitorAuctions URL
ProcessAutoBids URL
ProcessDutchBids URL
ProcessOpenCryBids URL
ShopperCreateForumMessage URL
UpdateGallery URL
CompleteOrder URL
Trading subsystem URLs