Reference > Shop flow URLs > Order Management subsystem URLs > Order payment
PayResetPM URL
This URL resets a payment for an order that has been submitted to WebSphere Commerce Payments for processing. Only an order that has failed submission can have its payment reset by using this command. If successful, this command returns the WebSphere Commerce order to the "pending" state so that the order can be re-submitted for processing.
URL syntax
- http:// host_name/path/
- The fully qualified name of the WebSphere Commerce Server and the configuration path.
Parameter values
- storeId
- The reference number of the store that is associated with this command.
- orderId
- Required: The reference number for the order having its payment reset.
- URL
- Required: The URL to be called when this command completes successfully.
Example
An example where the PayResetPM command could be used is found in the sample JavaServer Pages file, PayStatusPM.jsp, from the WC_INSTALL/samples/web/payment directory.
In the sample JSP file, we would display a button to allow the customer to reset the order if the payment status of the order is PAYMENTSTATE_DECLINED or PAYMENTSTATE_VOID. The redirect URL parameter would be set to the OrderDisplay command so that when the PayResetPM command completes, a list of pending orders owned by the customer would be displayed:
http://host_name/webapp/wcs/stores/PayResetPM?storeId=2066 &orderId=123&URL=OrderDisplay%3Fstatus=P
Behavior
- Resets payment for an order that has failed submission to WebSphere Commerce Payments for processing. Order submission to WebSphere Commerce Payments can fail for the following reasons:
- Rejected by the Acquirer due to insufficient funds.
- Rejected by the Acquirer because the card has expired.
- Returns the WebSphere Commerce order to the "pending" state so that the order can be re-submitted for processing.
- The URL that is called depends on the reason for failure.
- The ReverseUpdateInventoryCmd task command can be called to reverse the inventory updated for the Order if needed.
- The Order Status is updated to "P" if the command runs successfully.
Exception conditions
If the Order is not in the right state, this command throws the ECApplicationException specifying the "PayResetErrorView". For information about exceptions conditions, refer to the error codes for PayResetErrorView.
Related reference
WebSphere Commerce Payments commands
Error codes for PayResetErrorView