Paul,

Unless Protx provides a pre-compiled pipeline component which you can add to your solution, you're going to have to build your own pipeline component which you'll probably end up adding to your checkout pipeline.

Due to changes in the order system object model (specifically, the addition of the PaymentMethod collection), most third party systems do not have pre-compiled pipelines that will work with Commerce Server 2007. However, as long as Protx provides an API, you should be able to write your own pipeline components. If you need some resources to get started on writing pipeline components, this resource should be helpful.

http://msdn2.microsoft.com/en-us/library/ms944214.aspx

JosephJohnson at 2007-9-4 >

Yes, you will have to make SOAP requests to the Protx system from inside the pipeline (if that's the interface exposed by Protx).

JosephJohnson at 2007-9-4 >

Currently Commerce Server has one credit card processing pipeline which has single component which verifies the credit card number. If you're putting together a solution for a different payment type you'll need to create a new pipeline and will need to configure it in the web.config. Then you'll need to use the Customer and Order manager UI to configure the new payment method. You'll need to update the starter site to include the pages which will take the user inputs for the new payment type. Following documentation covers it in detail. These docs will be released on web very soon.

Creating a Custom Payment Method	Send Feedback
	See Also

Collapse All Expand All Language Filter: All Language Filter: Multiple Language Filter: Visual Basic Language Filter: C# Language Filter: C++ Language Filter: J# Language Filter: JScript

Development > Developing with the Orders System > Extending the Orders System >

Visual Basic (Declaration)
C#
C++
J#
JScript

For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.

You must create a custom payment method when you want to support a new way of paying for items such as an online payment system. To incorporate a new payment method into your site, you must first create and configure the payment method, and then implement the site code to use the new payment method. The topics in this section describe these two processes.

In This Section

· How to Configure a Custom Payment Method

· How to Use a Custom Payment Method from Site Code

See Also

Other Resources

Extending the Orders System

Documentation Feedback

Microsoft values your feedback. To rate this topic and send feedback about this topic to the documentation team, click a rating, and then click Send Feedback. For assistance with support issues, refer to the technical support information included with the product.

Poor

1

2

3

4

5

Outstanding

To e-mail your feedback to Microsoft, click here:

How to Configure a Custom Payment Method	Send Feedback
	See Also

Collapse All Expand All Language Filter: All Language Filter: Multiple Language Filter: Visual Basic Language Filter: C# Language Filter: C++ Language Filter: J# Language Filter: JScript

Developing with the Orders System > Extending the Orders System > Creating a Custom Payment Method >

Visual Basic (Declaration)
C#
C++
J#
JScript

For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.

A Commerce Server site processes payments by running the pipeline that corresponds to the payment method. To create a custom payment method, you must create a new payment processor and then configure your site to recognize the new payment method.

To create and configure a custom payment method

1. Create a pipeline component that processes the payment. For more information about how to perform this step, see Building Pipeline Components.

2. Use the Pipeline Component Registration tool (PipeReg.exe) to register the pipeline component. For more information about how to perform this step, see Building Pipeline Components.

3. Create a new pipeline that includes the payment processor that you created and registered in steps 1 and 2. For more information about how to perform this step, see How to Create a Custom Pipeline.

4. Update the Web.config file to reference the new pipeline. For more information about how to configure a pipeline in the Web.config file, see pipelines Element.

5. Follow the procedure in the topic How to Create a Payment Method to create the payment method. For the payment type property, select one of the payment types that start with the word "Custom".

See Also

Other Resources

Developing with Pipelines
How to Create a Payment Method
Creating a Custom Payment Method

Documentation Feedback

Microsoft values your feedback. To rate this topic and send feedback about this topic to the documentation team, click a rating, and then click Send Feedback. For assistance with support issues, refer to the technical support information included with the product.

Poor

1

2

3

4

5

Outstanding

To e-mail your feedback to Microsoft, click here:

How to Use a Custom Payment Method from Site Code	Send Feedback
	See Also

Collapse All Expand All Language Filter: All Language Filter: Multiple Language Filter: Visual Basic Language Filter: C# Language Filter: C++ Language Filter: J# Language Filter: JScript

Developing with the Orders System > Extending the Orders System > Creating a Custom Payment Method >

Visual Basic (Declaration)
C#
C++
J#
JScript

For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.

After you create a custom payment method, you must incorporate the new payment method into your site code. The changes to your site code include creating a new class to represent the new type of payment, and creating an instance of the class when the user chooses the new payment method.

Note

When you view an order in the Customer and Orders Manager, you will only see cash card, credit card, gift certificate, and purchase order payments. If you create a new type of payment by extending the Payment class, you must use the Commerce Server SDK to extend the user interface of the Customer and Orders Manager to view the new type of payment.

To use a custom payment method from your site code

1. Extend the Payment class to create a new class that represents paying by the new payment method. For more information about how to extend a core Orders System class, see How to Derive a New Orders Class.

2. Override the accessors on the ProtectedPaymentType member of the new class. The get accessor should return the payment type property that you selected when you created the new payment method. For information about how to view the properties of the payment method, see How to View Payment Method Details.

3. Modify your site code to create an instance of the class that you defined in the first step when the user chooses to pay by using the new payment method.

4. Update the OrderObjectMappings.xml file to map instances of the new class to the database. For more information about the OrderObjectMappings.xml file, see Mapping Purchase Orders to the Database.

5. Generate and run the SQL stored procedures to update the database. For more information about how to generate the SQL stored procedures, see How to Generate SQL Tables and Stored Procedures for Orders Mapped Storage.

6. Update the Types element in the Web.config file. For more information about this element, see Types Element.

See Also

Tasks

How to Derive a New Orders Class
How to Configure a Custom Payment Method

Other Resources

Mapping Purchase Orders to the Database
Creating a Custom Payment Method

Documentation Feedback

Microsoft values your feedback. To rate this topic and send feedback about this topic to the documentation team, click a rating, and then click Send Feedback. For assistance with support issues, refer to the technical support information included with the product.

Poor

1

2

3

4

5

Outstanding

To e-mail your feedback to Microsoft, click here:

VKUMAR-MSFT at 2007-9-4 >