\n";
/*****************************************************************
*** CREDIT CARD REQUEST ***
add_auth
add_shipping_address
add_ordertext
add_creditcard
add_billing_address
add_lineitem
add_option
add_option
add_lineitem (incl 2 option's)
*****************************************************************/
#@ add_auth
#~ Create an AUTH object in the request
#~ Optionally you can add shipping address and/or order text here instead
#~ of using their own functions.
## Syntax:
## object_identifier: add_auth (
## array: auth parameters
## ,[array: shipping address]
## ,[array: ordertext (type and text)]
## )
$auth = $ssp->add_auth(
array(
'ordernumber' => '18140517',
'ecommerce' => 'true',
'ecommercecode' => '07',
'ponumber' => 'Verbal Hagar',
'ipaddress' => $REMOTE_ADDR,
'shippingcost' => '0.93USD',
'taxamount' => '0.07USD',
'referringurl' => $HTTP_REFERER,
'browsertype' => $HTTP_USER_AGENT,
)
);
if ($ssp->err) die($ssp->err); # Die with error description
#@ add_shipping_address
#~ Create an ADDRESS object with type shipping. You want to attach this to
#~ the auth request, so use the return from that as a parent identifier here.
## Syntaxt:
## object_identifier: add_shipping_address (
## object identifier : parent object
## ,array: address details
## )
$ssp->add_shipping_address(
$auth,
array(
'fullname' => 'Hagar Tarball Horrible',
'address1' => '123 Pilage street',
'address2' => 'Suite 100',
'city' => 'Valhalla',
'state' => 'NA',
'zip' => '12345',
'country' => 'NO',
'phone' => '5555551234',
'email' => 'devnull@vikings.dot'
)
);
if ($ssp->err) die($ssp->err); # Die with error description
#@ add_ordertext
#~ Inserts (optional) ordertext.
#~ Remember: ordertext is very limited, check the Surepay SDK documentation,
#~ people keep asking me about this and getting errors, my advice: Skip it!
#~ (This could easily have been done in the add_auth function instead)
## Syntax:
## object_identifier: add_ordertext (
## object_identifier: parent object
## ,string: type set (description|instructions|classification)
## ,string: text (very limited length!)
## )
$ssp->add_ordertext(
$auth,
'instructions',
'Mark as '
);
if ($ssp->err) die($ssp->err); # Die with error description
#@ add_creditcard
#~ Adds a creditcard object. The cvv2 security feature should always be uses,
#~ therefor the cvv2status is 1 by default an no need to specify it.
#~ to turn it of, set code to 0 and status to 0. Status 9 can be
#~ uses optionally if the clients card has no code.
## Syntax:
## object_identifier: add_creditcard (
## object_identifier: parent object
## ,string: card number
## ,string: expiration (mm/yy)
## ,int: cvv2 code from card
## [,int: cvv2status (security mode) (0|1|9) default is 1 (In Use)]
## [,array: billing address]
## )
# This sample does not use the cvv2 code since it is a test request
# according to the surepay SDK specifications
$creditcard = $ssp->add_creditcard(
$auth,
'4012000033330026',
'12/05',
'0',
'0'
);
#@ add_billing_address
#~ Create an ADDRESS object with type billing. You want to attach this to
#~ the payment object, so use the return from that as a parent identifier here.
## Syntaxt:
## object_identifier: add_billing_address (
## object identifier : parent object
## ,array: address details
## )
$ssp->add_billing_address(
$creditcard,
array(
'fullname' => 'Hagar T Horrible',
'address1' => '123 Pilage street',
'address2' => 'Kitchen Delivery Door',
'city' => 'Valhalla',
'state' => 'NA',
'zip' => '12345',
'country' => 'NO',
'phone' => '5555551234',
'email' => 'devnull@vikings.dot'
)
);
if ($ssp->err) die($ssp->err); # Die with error description
#@ add_lineitem
#~ Adds an item to the order. We recommend splitting it up and not
#~ collect a total sum in one item. If you add only one item with the
#~ total charge, it is between you, surepay, and your merchant account
#~ provider to determine if it is the right way or not.
#~ alternatively you can add option sub objects in the same function.
## Syntax:
## object_identifier: add_lineitem (
## object_identifier: parent object (The AUTH object)
## ,int: quantity,
## ,string: sku,
## ,string: description,
## ,string: unit cost (currency) [d..d]d.ccUSD
## ,real: taxrate in decimal notation (0.08 = 8%)
## [,array: options ]
## )
$item = $ssp->add_lineitem (
$auth,
'60',
'BEER_001',
'Sixpack Samuel Adamas Boston Lager',
'5.00USD',
'0.08'
);
if ($ssp->err) die($ssp->err); # Die with error description
#@ add_option
#~ Add options to lineitem
## Syntax:
## object_identifier: add_option (
## object_identifier: parent object
## ,string: option label
## ,string: option value
## )
$ssp->add_option($item,'color','brown');
if ($ssp->err) die($ssp->err); # Die with error description
$ssp->add_option($item,'bottle','glas');
if ($ssp->err) die($ssp->err); # Die with error description
# Add another lineitem object (inlcuding two options) in the AUTH object
$item = $ssp->add_lineitem (
$auth,
'1',
'BEER_052',
'Sixpack George Killians Irish Red',
'5.00USD',
'0.08',
array (
'type' => 'domestic',
'logo' => 'horsehead'
)
);
if ($ssp->err) die($ssp->err); # Die with error description
# This ends the Creditcard request, it could have been used as it is
# at this point to do a request to surepay.
/*************************************************************
*** TELECHECK REQUEST ***
add_auth (inluding shipping address and ordertext)
add_telecheck (including billing address and id)
add_lineitem (incl option)
add_lineitem
**************************************************************/
# Every function is not commented with syntax etc here,
# Only the ones not commented above.
# First we'll add another AUTH object to our request
# This time we'll include shipping address and ordertext in the same
# function.
$auth = $ssp->add_auth(
array(
'ordernumber' => '18140518',
'ecommerce' => 'true',
'ecommercecode' => '07',
'ponumber' => 'E-mail Hagar',
'ipaddress' => $REMOTE_ADDR,
'shippingcost' => '1.00USD',
'taxamount' => '0.00USD',
'referringurl' => $HTTP_REFERER,
'browsertype' => $HTTP_USER_AGENT,
),
array(
'fullname' => 'Jr. Hagar Horrible',
'address1' => '145 Vaernes Gata',
'address2' => 'Poelse med Lompe',
'city' => 'Valhalla',
'state' => 'NA',
'zip' => '12345',
'country' => 'NO',
'phone' => '+4712555554',
'email' => 'devnull@vikings.dot'
),
array(
'instructions' => 'Pottittstappe med saus'
)
);
if ($ssp->err) die($ssp->err); # Die with error description
#@ add_telecheck
#~ Adds a telecheck object. See http://www.telecheck.com for info on what it is
#~ Basically it lets people pay with a paper check, telecheck "Converts" it to
#~ an electronic payment. You must have a TeleCheck Merchant account to use it!
## Syntax:
## object_identifier: add_telecheck (
## object_identifier: parent object
## ,string: Check number
## ,string: MICR number (Continous string of EVERY number on the bottom of the check)
## ,boolean: isbusiness (true = business, false=persona)
## [,array: identification object attributes (Dr.license)]
## [,array: billing address]
## )
# This sample does not use the cvv2 code since it is a test request
# according to the surepay SDK specifications
$telecheck = $ssp->add_telecheck (
$auth,
'1001',
'1234567804390850001001',
'true',
array (
'type' => 'driverslicense',
'number' => '123123123',
'issuedby' => 'NY'
),
array(
'fullname' => 'Hagar Zipdrive Horrible',
'address1' => 'PO Box 1',
'city' => 'Valhalla',
'state' => 'NA',
'zip' => '12345',
'country' => 'NO',
'phone' => '+4712555554',
'email' => 'devnull@vikings.dot'
)
);
if ($ssp->err) die($ssp->err); # Die with error description
/* Alternatively you could have used the separate functions
add_id_driverslicense and add_billing_address instead */
#@ add_id_driverslicense
#~ Add a id object of type driverslicense
## Syntax:
## object_identifier: add_id_driverslicense (
## object_identifier: parent object
## ,string: number (License number)
## ,string: issuedby (In US use state 2 letter abreviation code)
## )
/*
Sample of usage:
(Not used in test script since already included in add_telecheck sample)
$ssp->add_id_driverslicense (
$telecheck,
'321321321',
'CA'
);
*/
# Add a couple of items
$item = $ssp->add_lineitem (
$auth,
'1',
'BEER_021',
'Heineken Dark',
'5.00USD',
'0.08',
array (
'type' => 'import',
)
);
if ($ssp->err) die($ssp->err); # Die with error description
$item = $ssp->add_lineitem (
$auth,
'1',
'BEER_031',
'Bass',
'5.00USD',
'0.08'
);
if ($ssp->err) die($ssp->err); # Die with error description
# This ends the Telecheck request
/*************************************************************
*** Submittal to Surepay's server and response decode ***
**************************************************************/
#@ prepare_request
#~ Takes all the added objects and creates XML data
#~ The XML data is stored in variable xml_request as well as returned
#~ You MUST execute this before posting a request
## Syntax:
## string: prepare_request ()
$ssp->prepare_request();
if ($ssp->err) die($ssp->err); # Die with error description
# At this point in the script you could:
# Use the created XML data and submit by other means
# or
# Have built the XML data your self and assign it to xml_request
# or
# Manipulate the XML data to fit spesific needs or perhaps store it
# in a database or file or send email (USE ENCRYPTION!!!)
# Give some output for this test script
echo " " .
htmlentities($ssp->xml_request,ENT_QUOTES) . "\n
";
#@ submit_request
#~ Submits your prepared XML data to the surepay server and
#~ awaits a response. The response is stored in xml_response,
#~ as well as being returned.
## Syntax
## string: submit_request (
## [ integer: timeout in seconds (default 90)]
## [,integer: SSL version (0|2|3)]
## )
$ssp->submit_request();
if ($ssp->err) die($ssp->err); # Die with error description
# Give some respons output to the test script
echo "" .
htmlentities($ssp->xml_response,ENT_QUOTES) . "\n
";
#@ parse_response
#~ Parses received response data and returns a total amount of responses
## Syntax:
## int: parse_response ()
$responsecount = $ssp->parse_response();
if ($ssp->err) die($ssp->err); # Die with error description
if (!$responsecount) {
echo "We got 0 responses? Something must have gone wrong somewhere...\n";
exit; # Seems to be no real error?
}
#@ auths
#~ returns an array holding the keys of all responses of type AUTH
## Syntax:
## array: auths( )
$auths = $ssp->auths();
if ($ssp->err) die($ssp->err); # Die with error description
# Output our responses and their status to the test script
# This output is a little messy, but you get the general idea
# from the auth_status control.
# It is up to you and your application how to handle the
# various states, check avs and cvv2 status and so on...
echo "".$responsecount." responses was successfully parsed
\n"; while (list($key,$order)=each($auths)) { echo "Response $key - Ordernumber $order
\n";
echo "Transaction id: ".($ssp->auth_trans_id($order))."
\n";
echo "Authorization status: " . $ssp->auth_status($order) . " --> ";
if ($ssp->auth_status($order) == 'AUTH') echo 'Successfull authorized';
elseif ($ssp->auth_status($order) == 'DCL') echo 'Declined';
elseif ($ssp->auth_status($order) == 'REF') echo 'Refered (NOT authorized!)';
elseif ($ssp->auth_status($order) == 'ERR') echo 'An error occured while processing';
else echo 'Unknown or no status type (probably failure)';
echo "
\n";
echo "Authcode: " . $ssp->auth_authcode($order) . "
\n";
echo "cvv2result: " . $ssp->auth_cvv2result($order) . "
\n";
echo "avs: " . $ssp->auth_avs($order) . "
\n";
echo "failure: " . $ssp->auth_failure($order) . "
\n";
echo "error text: " . $ssp->auth_text($order) . "