IClientPaymentProvider::GeneratePaymentInformation

Syntax

HRESULT GeneratePaymentInformation(
BSTRbstrFriendname// in
BSTRbstrTotal// in
BSTRbstrHashOrder// in
BSTRbstrAcceptTypes// in
SAFEARRAY (VARIANT) *ppsa// out
);

Description

The GeneratePaymentInformation function returns a payment instruction (PI) based upon the instance.

If you are using a third-party CPC, the HTML (or .asp) page needs to handle the fields that the CPC returns from the GeneratePaymentInformation call. To do this, these fields need to be added to the hidden form on your HTML page in order to get posted. You should also add the lines to initialize these form fields to their appropriate values.

Note  When this function is called, a dialog box should be displayed to the consumer warning that a specific instance of a payment type is being charged for a shopping transaction.

Parameters

bstrFriendName

Friendly name of the instance upon which the PI is based.

bstrTotal

Total amount that the user is being asked to verify. This amount should be presented to the user for confirmation of the order.

bstrHashOrder

Cryptographic hash of the contents of the order. Some protocols package this into the payment instruction. Each CPC determines what is allowed in this field.

bstrAcceptTypes

List of the accepted types provided by the merchant.

ppsa

Pointer to a two-dimensional safe array of name/value pairs whose names and values are stored as BSTRs. Name/value pairs contain the name of a field and the value assigned to that field.

Return Value

This function returns one of the following values.