ok
Direktori : /home2/selectio/public_html/fms-worksuite/vendor/authorizenet/authorizenet/doc/ |
Current File : /home2/selectio/public_html/fms-worksuite/vendor/authorizenet/authorizenet/doc/AIM.markdown |
Advanced Integration Method =========================== Basic Overview -------------- The AuthorizeNetAIM class creates a request object for submitting transactions to the AuthorizeNetAIM API. To use, create an instance of the class, set the fields for your transaction, call the method you want to use (Authorize Only, Authorize & Capture, etc.) and you'll receive an AuthorizeNetAIM response object providing easy access to the results of the transaction. Autoloading ----------------- ```PHP require 'vendor/autoload.php'; ``` Setting Merchant Credentials ---------------------------- The easiest way to set credentials is to define constants which the SDK uses: ```PHP define("AUTHORIZENET_API_LOGIN_ID", "YOURLOGIN"); define("AUTHORIZENET_TRANSACTION_KEY", "YOURKEY"); ``` You can also set credentials manually per request like so: ```PHP $sale = new AuthorizeNetAIM("YOUR_API_LOGIN_ID","YOUR_TRANSACTION_KEY"); ``` Setting the Transaction Post Location ------------------------------------- To post transactions to the live Authorize.Net gateway: ```PHP define("AUTHORIZENET_SANDBOX", false); ``` To post transactions to the Authorize.Net test server: ```PHP define("AUTHORIZENET_SANDBOX", true); ``` You can also set the location manually per request: ```PHP $sale->setSandbox(false); ``` Setting Fields -------------- An Authorize.Net AIM request is simply a set of name/value pairs. The PHP SDK allows you to set these fields in a few different ways depending on your preference. Note: to make things easier on the developer, the "x_" prefix attached to each field in the AIM API has been removed. Thus, instead of setting `$sale->x_card_num`, set `$sale->card_num` instead. 1.) By Setting Fields Directly: ```PHP $sale = new AuthorizeNetAIM; $sale->amount = "1999.99"; $sale->card_num = '6011000000000012'; $sale->exp_date = '04/15'; $response = $sale->authorizeAndCapture(); ``` 2.) By Setting Multiple Fields at Once: ```PHP $sale = new AuthorizeNetAIM; $sale->setFields( array( 'amount' => rand(1, 1000), 'card_num' => '6011000000000012', 'exp_date' => '0415' ) ); ``` 3.) By Setting Special Items To add line items or set custom fields use the respective functions: Line Items: ```PHP $sale->addLineItem( 'item1', // Item Id 'Golf tees', // Item Name 'Blue tees', // Item Description '2', // Item Quantity '5.00', // Item Unit Price 'N' // Item taxable ); ``` Custom Fields: ```PHP $sale->setCustomField("coupon_code", "SAVE2011"); ``` 4.) By Passing in Objects Each property will be copied from the object to the AIM request. ```PHP $sale = new AuthorizeNetAIM; $customer = (object)array(); $customer->first_name = "Jane"; $customer->last_name = "Smith"; $customer->company = "Jane Smith Enterprises Inc."; $customer->address = "20 Main Street"; $customer->city = "San Francisco"; $customer->state = "CA"; $customer->zip = "94110"; $customer->country = "US"; $customer->phone = "415-555-5557"; $customer->fax = "415-555-5556"; $customer->email = "foo@example.com"; $customer->cust_id = "55"; $customer->customer_ip = "98.5.5.5"; $sale->setFields($customer); ``` Submitting Transactions ----------------------- To submit a transaction call one of the 7 methods: ```PHP AuthorizeNetAIM::authorizeAndCapture() AuthorizeNetAIM::authorizeOnly() AuthorizeNetAIM::priorAuthCapture() AuthorizeNetAIM::void() AuthorizeNetAIM::captureOnly() AuthorizeNetAIM::credit() ``` Each method has optional parameters which highlight the fields required by the Authorize.Net API for that transaction type. eCheck ------ To submit an electronic check transaction you can set the required fields individually or simply use the setECheck method: ```PHP $sale = new AuthorizeNetAIM; $sale->amount = "45.00"; $sale->setECheck( '121042882', // bank_aba_code '123456789123', // bank_acct_num 'CHECKING', // bank_acct_type 'Bank of Earth', // bank_name 'Jane Doe', // bank_acct_name 'WEB' // echeck_type ); $response = $sale->authorizeAndCapture(); ``` Partial Authorization Transactions ---------------------------------- To enable partial authorization transactions set the partial_auth flag to true: ```PHP $sale->allow_partial_auth = true; ``` You should receive a split tender id in the response if a partial auth is made: ```PHP $split_tender_id = $response->split_tender_id; ``` Itemized Order Information -------------------------- To add itemized order information use the addLineItem method: ```PHP $auth->addLineItem( 'item1', // Item Id 'Golf tees', // Item Name 'Blue tees', // Item Description '2', // Item Quantity '5.00', // Item Unit Price 'N' // Item taxable ); ``` Merchant Defined Fields ----------------------- You can use the setCustomField method to set any custom merchant defined field(s): ```PHP $sale->setCustomField("entrance_source", "Search Engine"); $sale->setCustomField("coupon_code", "SAVE2011"); ``` Transaction Response -------------------- When you submit an AIM transaction you receive an AuthorizeNetAIM_Response object in return. You can access each name/value pair in the response as you would normally expect: ```PHP $response = $sale->authorizeAndCapture(); $response->response_code; $response->response_subcode; $response->response_reason_code; $response->transaction_id; ```