Class: Payment_Process_Result

The core result class that should be returned from each driver's process() function. This should be extended as Payment_Process_Result_DriverName and then have the appropriate fields mapped out accordingly.

Take special care to appropriately create a parse() function in your result class. You can then call _mapFields() with a resultArray (ie. exploded result) to map your results from parse() into the member variables.

Please note that this class keeps your original codes intact so they can be accessed directly and then uses the function wrappers to return uniform Payment_Process codes.

Author: Joe Stump <joe@joestump.net>
Version: @version@

[ Top ]

Class Variables

$approvalCode =

[line 381]

Authorization/Approval code

Author: Joe Stump <joe@joestump.net>
Access: public

Type:

string

[ Top ]

$avsCode =

[line 398]

Address verification code

The AVS code returned from your gateway. This should then be mapped to the appropriate PAYMENT_PROCESS_AVS_* code using $_avsCodeMap. This value should also be mapped to the appropriate textual message via the $_avsCodeMessages array.

Author: Joe Stump <joe@joestump.net>
See: $_avsCodeMessages
See: PAYMENT_PROCESS_AVS_MATCH, PAYMENT_PROCESS_AVS_NOAPPLY, $_avsCodeMap
See: PAYMENT_PROCESS_AVS_MISMATCH, PAYMENT_PROCESS_AVS_ERROR
Access: public

Type:

string

[ Top ]

$code =

[line 343]

The approval/decline code

The value returned by your gateway as approved/declined should be mapped into this variable. Valid results should then be mapped into the appropriate PAYMENT_PROCESS_RESULT_* code using the $_statusCodeMap array. Values returned into $code should be mapped as keys in the map with PAYMENT_PROCESS_RESULT_* as the values.

Author: Joe Stump <joe@joestump.net>
See: PAYMENT_PROCESS_RESULT_APPROVED, PAYMENT_PROCESS_RESULT_DECLINED
See: PAYMENT_PROCESS_RESULT_OTHER, $_statusCodeMap
Access: public

Type:

mixed

[ Top ]

$customerId =

[line 436]

Customer ID

Unique internal customer ID (ie. your company's customer ID used to track individual customers).

Author: Joe Stump <joe@joestump.net>
Access: public

Type:

string

[ Top ]

$cvvCode = PAYMENT_PROCESS_CVV_NOAPPLY

[line 449]

CVV Code

The CVV code is the 3-4 digit number on the back of most credit cards. This value should be mapped via the $_cvvCodeMap variable to the appropriate PAYMENT_PROCESS_CVV_* values.

Author: Joe Stump <joe@joestump.net>
Access: public

Type:

string

[ Top ]

$cvvMessage = 'No CVV message from gateway'

[line 462]

CVV Message

Your cvvCode value should be mapped to appropriate messages via the $_cvvCodeMessage array. This value is merely here to hold the value returned from the gateway (if any).

Author: Joe Stump <joe@joestump.net>
Access: public

Type:

string

[ Top ]

$invoiceNumber =

[line 424]

Invoice Number

Unique internal invoiceNumber (ie. your company's order/invoice number that you assign each order as it is processed). It is always a good idea to pass this to the gateway (which is usually then echo'd back).

Author: Joe Stump <joe@joestump.net>
Access: public

Type:

string

[ Top ]

$message = 'No message from gateway'

[line 372]

Message from gateway

Map the textual message from the gateway into this variable. It is not currently returned or used (in favor of the $_statusCodeMessages map, but can be accessed directly for debugging purposes.

Author: Joe Stump <joe@joestump.net>
See: $_statusCodeMessages
Access: public

Type:

string

[ Top ]

$messageCode =

[line 358]

Message/Response Code

Along with the response (yes/no) you usually get a response/message code that translates into why it was approved/declined. This is where you map that code into. Your $_statusCodeMessages would then be keyed by valid messageCode values.

Author: Joe Stump <joe@joestump.net>
See: $_statusCodeMessages
Access: public

Type:

mixed

[ Top ]

$transactionId =

[line 411]

Transaction ID

This is the unique transaction ID, which is used by gateways to modify transactions (credit, update, etc.). Map the appropriate value into this variable.

Author: Joe Stump <joe@joestump.net>
Access: public

Type:

string

[ Top ]

$_rawResponse = null

[line 326]

The raw response (ie. from cURL)

Author: Joe Stump <joe@joestump.net>
Access: protected

Type:

string

[ Top ]

Method Detail

Payment_Process_Result (Constructor) [line 464]

Payment_Process_Result Payment_Process_Result(

$rawResponse, 
$request)

Parameters:

	`$rawResponse`	—
	`$request`	—

[ Top ]

accept [line 645]

boolean accept(

&$object, object
$object)

Accept an object

Return: true if accepted, false otherwise

Parameters:

object	`$object`	—	Object to accept
	`&$object`	—

[ Top ]

factory [line 480]

mixed &factory(
string
$type, string
$rawResponse, mixed
$request)

factory

Return: Payment_Process_Result on succes, PEAR_Error on failure
Author: Joe Stump <joe@joestump.net>
Author: Ian Eure <ieure@php.net>

Parameters:

string	`$type`	—
string	`$rawResponse`	—
mixed	`$request`	—

[ Top ]

getAVSCode [line 606]

void getAVSCode(
)

[ Top ]

getAVSMessage [line 611]

void getAVSMessage(
)

[ Top ]

getCode [line 576]

void getCode(
)

getCode

Author: Joe Stump <joe@joestump.net>
Access: public

Overridden in child classes as:

Payment_Process_Result_Bibit::getCode()

Payment_Process_Result_Transfirst::getCode()

[ Top ]

getCvvCode [line 616]

void getCvvCode(
)

[ Top ]

getCvvMessage [line 621]

void getCvvMessage(
)

[ Top ]

getMessage [line 595]

string getMessage(
)

getMessage

Return the message from the code map, or return the raw message if there is one. Otherwise, return a worthless message.

Author: Joe Stump <joe@joestump.net>
Access: public

[ Top ]

isLegitimate [line 564]

void isLegitimate(
)

isLegitimate

Some gateways allow you to validate the response to make sure it's actually them that are sending the response. Override this in the driver result class and implement this if your gateway provides such a mechanism. Any information required should be passed via $options.

Author: Joe Stump <joe@joestump.net>
Abstract:
Access: public

Overridden in child classes as:

Payment_Process_Result_AuthorizeNet::isLegitimate(): Validates the legitimacy of the response

[ Top ]

log [line 662]

mixed log(
string
$message, [string
$priority = null])

Log a message

Return: Return value of Log::log(), or false if no Log instance has been accepted.

Parameters:

string	`$message`	—	Message to log
string	`$priority`	—	Message priority

[ Top ]

parse [line 532]

void parse(
)

parse

Author: Joe Stump <joe@joestump.net>
Abstract:
Access: public

Overridden in child classes as:

Payment_Process_Result_Bibit::parse()

Payment_Process_Result_TrustCommerce::parse()

Payment_Process_Result_AuthorizeNet::parse(): Parses the data received from the payment gateway

Payment_Process_Result_LinkPoint::parse(): parse

[ Top ]

parseCallback [line 546]

void parseCallback(
)

parseCallback

Author: Joe Stump <joe@joestump.net>
See: Payment_Process_Common::processCallback()
Abstract:
Access: public

Overridden in child classes as:

Payment_Process_Result_AuthorizeNet::parseCallback(): Parses the data received from the payment gateway callback

[ Top ]

validate [line 497]

mixed validate(
)

validate

Author: Joe Stump <joe@joestump.net>
Access: public

[ Top ]