Your IP : 216.73.216.95
<?php
/**
* Braintree Transaction processor
* Creates and manages transactions
*
* At minimum, an amount, credit card number, and
* credit card expiration date are required.
*
* <b>Minimalistic example:</b>
* <code>
* Braintree_Transaction::saleNoValidate(array(
* 'amount' => '100.00',
* 'creditCard' => array(
* 'number' => '5105105105105100',
* 'expirationDate' => '05/12',
* ),
* ));
* </code>
*
* <b>Full example:</b>
* <code>
* Braintree_Transaction::saleNoValidate(array(
* 'amount' => '100.00',
* 'orderId' => '123',
* 'channel' => 'MyShoppingCardProvider',
* 'creditCard' => array(
* // if token is omitted, the gateway will generate a token
* 'token' => 'credit_card_123',
* 'number' => '5105105105105100',
* 'expirationDate' => '05/2011',
* 'cvv' => '123',
* ),
* 'customer' => array(
* // if id is omitted, the gateway will generate an id
* 'id' => 'customer_123',
* 'firstName' => 'Dan',
* 'lastName' => 'Smith',
* 'company' => 'Braintree',
* 'email' => 'dan@example.com',
* 'phone' => '419-555-1234',
* 'fax' => '419-555-1235',
* 'website' => 'http://braintreepayments.com'
* ),
* 'billing' => array(
* 'firstName' => 'Carl',
* 'lastName' => 'Jones',
* 'company' => 'Braintree',
* 'streetAddress' => '123 E Main St',
* 'extendedAddress' => 'Suite 403',
* 'locality' => 'Chicago',
* 'region' => 'IL',
* 'postalCode' => '60622',
* 'countryName' => 'United States of America'
* ),
* 'shipping' => array(
* 'firstName' => 'Andrew',
* 'lastName' => 'Mason',
* 'company' => 'Braintree',
* 'streetAddress' => '456 W Main St',
* 'extendedAddress' => 'Apt 2F',
* 'locality' => 'Bartlett',
* 'region' => 'IL',
* 'postalCode' => '60103',
* 'countryName' => 'United States of America'
* ),
* 'customFields' => array(
* 'birthdate' => '11/13/1954'
* )
* )
* </code>
*
* <b>== Storing in the Vault ==</b>
*
* The customer and credit card information used for
* a transaction can be stored in the vault by setting
* <i>transaction[options][storeInVault]</i> to true.
* <code>
* $transaction = Braintree_Transaction::saleNoValidate(array(
* 'customer' => array(
* 'firstName' => 'Adam',
* 'lastName' => 'Williams'
* ),
* 'creditCard' => array(
* 'number' => '5105105105105100',
* 'expirationDate' => '05/2012'
* ),
* 'options' => array(
* 'storeInVault' => true
* )
* ));
*
* echo $transaction->customerDetails->id
* // '865534'
* echo $transaction->creditCardDetails->token
* // '6b6m'
* </code>
*
* To also store the billing address in the vault, pass the
* <b>addBillingAddressToPaymentMethod</b> option.
* <code>
* Braintree_Transaction.saleNoValidate(array(
* ...
* 'options' => array(
* 'storeInVault' => true
* 'addBillingAddressToPaymentMethod' => true
* )
* ));
* </code>
*
* <b>== Submitting for Settlement==</b>
*
* This can only be done when the transction's
* status is <b>authorized</b>. If <b>amount</b> is not specified,
* the full authorized amount will be settled. If you would like to settle
* less than the full authorized amount, pass the desired amount.
* You cannot settle more than the authorized amount.
*
* A transaction can be submitted for settlement when created by setting
* $transaction[options][submitForSettlement] to true.
*
* <code>
* $transaction = Braintree_Transaction::saleNoValidate(array(
* 'amount' => '100.00',
* 'creditCard' => array(
* 'number' => '5105105105105100',
* 'expirationDate' => '05/2012'
* ),
* 'options' => array(
* 'submitForSettlement' => true
* )
* ));
* </code>
*
* <b>== More information ==</b>
*
* For more detailed information on Transactions, see {@link http://www.braintreepayments.com/gateway/transaction-api http://www.braintreepaymentsolutions.com/gateway/transaction-api}
*
* @package Braintree
* @category Resources
* @copyright 2014 Braintree, a division of PayPal, Inc.
*
*
* @property-read string $avsErrorResponseCode
* @property-read string $avsPostalCodeResponseCode
* @property-read string $avsStreetAddressResponseCode
* @property-read string $cvvResponseCode
* @property-read string $id transaction id
* @property-read string $amount transaction amount
* @property-read object $billingDetails transaction billing address
* @property-read string $createdAt transaction created timestamp
* @property-read object $applePayCardDetails transaction Apple Pay card info
* @property-read object $androidPayCardDetails transaction Android Pay card info
* @property-read object $creditCardDetails transaction credit card info
* @property-read object $coinbaseDetails transaction Coinbase account info
* @property-read object $paypalDetails transaction paypal account info
* @property-read object $customerDetails transaction customer info
* @property-read array $customFields custom fields passed with the request
* @property-read string $processorResponseCode gateway response code
* @property-read string $additionalProcessorResponse raw response from processor
* @property-read object $shippingDetails transaction shipping address
* @property-read string $status transaction status
* @property-read array $statusHistory array of StatusDetails objects
* @property-read string $type transaction type
* @property-read string $updatedAt transaction updated timestamp
* @property-read object $disbursementDetails populated when transaction is disbursed
* @property-read object $disputes populated when transaction is disputed
*
*/
final class Braintree_Transaction extends Braintree_Base
{
// Transaction Status
const AUTHORIZATION_EXPIRED = 'authorization_expired';
const AUTHORIZING = 'authorizing';
const AUTHORIZED = 'authorized';
const GATEWAY_REJECTED = 'gateway_rejected';
const FAILED = 'failed';
const PROCESSOR_DECLINED = 'processor_declined';
const SETTLED = 'settled';
const SETTLING = 'settling';
const SUBMITTED_FOR_SETTLEMENT = 'submitted_for_settlement';
const VOIDED = 'voided';
const UNRECOGNIZED = 'unrecognized';
const SETTLEMENT_DECLINED = 'settlement_declined';
const SETTLEMENT_PENDING = 'settlement_pending';
// Transaction Escrow Status
const ESCROW_HOLD_PENDING = 'hold_pending';
const ESCROW_HELD = 'held';
const ESCROW_RELEASE_PENDING = 'release_pending';
const ESCROW_RELEASED = 'released';
const ESCROW_REFUNDED = 'refunded';
// Transaction Types
const SALE = 'sale';
const CREDIT = 'credit';
// Transaction Created Using
const FULL_INFORMATION = 'full_information';
const TOKEN = 'token';
// Transaction Sources
const API = 'api';
const CONTROL_PANEL = 'control_panel';
const RECURRING = 'recurring';
// Gateway Rejection Reason
const AVS = 'avs';
const AVS_AND_CVV = 'avs_and_cvv';
const CVV = 'cvv';
const DUPLICATE = 'duplicate';
const FRAUD = 'fraud';
const THREE_D_SECURE = 'three_d_secure';
const APPLICATION_INCOMPLETE = 'application_incomplete';
// Industry Types
const LODGING_INDUSTRY = 'lodging';
const TRAVEL_AND_CRUISE_INDUSTRY = 'travel_cruise';
/**
* sets instance properties from an array of values
*
* @ignore
* @access protected
* @param array $transactionAttribs array of transaction data
* @return none
*/
protected function _initialize($transactionAttribs)
{
$this->_attributes = $transactionAttribs;
if (isset($transactionAttribs['applePay'])) {
$this->_set('applePayCardDetails',
new Braintree_Transaction_ApplePayCardDetails(
$transactionAttribs['applePay']
)
);
}
if (isset($transactionAttribs['androidPayCard'])) {
$this->_set('androidPayCardDetails',
new Braintree_Transaction_AndroidPayCardDetails(
$transactionAttribs['androidPayCard']
)
);
}
if (isset($transactionAttribs['creditCard'])) {
$this->_set('creditCardDetails',
new Braintree_Transaction_CreditCardDetails(
$transactionAttribs['creditCard']
)
);
}
if (isset($transactionAttribs['coinbaseAccount'])) {
$this->_set('coinbaseDetails',
new Braintree_Transaction_CoinbaseDetails(
$transactionAttribs['coinbaseAccount']
)
);
}
if (isset($transactionAttribs['paypal'])) {
$this->_set('paypalDetails',
new Braintree_Transaction_PayPalDetails(
$transactionAttribs['paypal']
)
);
}
if (isset($transactionAttribs['customer'])) {
$this->_set('customerDetails',
new Braintree_Transaction_CustomerDetails(
$transactionAttribs['customer']
)
);
}
if (isset($transactionAttribs['billing'])) {
$this->_set('billingDetails',
new Braintree_Transaction_AddressDetails(
$transactionAttribs['billing']
)
);
}
if (isset($transactionAttribs['shipping'])) {
$this->_set('shippingDetails',
new Braintree_Transaction_AddressDetails(
$transactionAttribs['shipping']
)
);
}
if (isset($transactionAttribs['subscription'])) {
$this->_set('subscriptionDetails',
new Braintree_Transaction_SubscriptionDetails(
$transactionAttribs['subscription']
)
);
}
if (isset($transactionAttribs['descriptor'])) {
$this->_set('descriptor',
new Braintree_Descriptor(
$transactionAttribs['descriptor']
)
);
}
if (isset($transactionAttribs['disbursementDetails'])) {
$this->_set('disbursementDetails',
new Braintree_DisbursementDetails($transactionAttribs['disbursementDetails'])
);
}
$disputes = array();
if (isset($transactionAttribs['disputes'])) {
foreach ($transactionAttribs['disputes'] AS $dispute) {
$disputes[] = Braintree_Dispute::factory($dispute);
}
}
$this->_set('disputes', $disputes);
$statusHistory = array();
if (isset($transactionAttribs['statusHistory'])) {
foreach ($transactionAttribs['statusHistory'] AS $history) {
$statusHistory[] = new Braintree_Transaction_StatusDetails($history);
}
}
$this->_set('statusHistory', $statusHistory);
$addOnArray = array();
if (isset($transactionAttribs['addOns'])) {
foreach ($transactionAttribs['addOns'] AS $addOn) {
$addOnArray[] = Braintree_AddOn::factory($addOn);
}
}
$this->_set('addOns', $addOnArray);
$discountArray = array();
if (isset($transactionAttribs['discounts'])) {
foreach ($transactionAttribs['discounts'] AS $discount) {
$discountArray[] = Braintree_Discount::factory($discount);
}
}
$this->_set('discounts', $discountArray);
if(isset($transactionAttribs['riskData'])) {
$this->_set('riskData', Braintree_RiskData::factory($transactionAttribs['riskData']));
}
if(isset($transactionAttribs['threeDSecureInfo'])) {
$this->_set('threeDSecureInfo', Braintree_ThreeDSecureInfo::factory($transactionAttribs['threeDSecureInfo']));
}
}
/**
* returns a string representation of the transaction
* @return string
*/
public function __toString()
{
// array of attributes to print
$display = array(
'id', 'type', 'amount', 'status',
'createdAt', 'creditCardDetails', 'customerDetails'
);
$displayAttributes = array();
foreach ($display AS $attrib) {
$displayAttributes[$attrib] = $this->$attrib;
}
return __CLASS__ . '[' .
Braintree_Util::attributesToString($displayAttributes) .']';
}
public function isEqual($otherTx)
{
return $this->id === $otherTx->id;
}
public function vaultCreditCard()
{
$token = $this->creditCardDetails->token;
if (empty($token)) {
return null;
}
else {
return Braintree_CreditCard::find($token);
}
}
public function vaultCustomer()
{
$customerId = $this->customerDetails->id;
if (empty($customerId)) {
return null;
}
else {
return Braintree_Customer::find($customerId);
}
}
public function isDisbursed() {
return $this->disbursementDetails->isValid();
}
/**
* factory method: returns an instance of Braintree_Transaction
* to the requesting method, with populated properties
*
* @ignore
* @return object instance of Braintree_Transaction
*/
public static function factory($attributes)
{
$instance = new self();
$instance->_initialize($attributes);
return $instance;
}
// static methods redirecting to gateway
public static function cloneTransaction($transactionId, $attribs)
{
return Braintree_Configuration::gateway()->transaction()->cloneTransaction($transactionId, $attribs);
}
public static function createFromTransparentRedirect($queryString)
{
return Braintree_Configuration::gateway()->transaction()->createFromTransparentRedirect($queryString);
}
public static function createTransactionUrl()
{
return Braintree_Configuration::gateway()->transaction()->createTransactionUrl();
}
public static function credit($attribs)
{
return Braintree_Configuration::gateway()->transaction()->credit($attribs);
}
public static function creditNoValidate($attribs)
{
return Braintree_Configuration::gateway()->transaction()->creditNoValidate($attribs);
}
public static function find($id)
{
return Braintree_Configuration::gateway()->transaction()->find($id);
}
public static function sale($attribs)
{
return Braintree_Configuration::gateway()->transaction()->sale($attribs);
}
public static function saleNoValidate($attribs)
{
return Braintree_Configuration::gateway()->transaction()->saleNoValidate($attribs);
}
public static function search($query)
{
return Braintree_Configuration::gateway()->transaction()->search($query);
}
public static function fetch($query, $ids)
{
return Braintree_Configuration::gateway()->transaction()->fetch($query, $ids);
}
public static function void($transactionId)
{
return Braintree_Configuration::gateway()->transaction()->void($transactionId);
}
public static function voidNoValidate($transactionId)
{
return Braintree_Configuration::gateway()->transaction()->voidNoValidate($transactionId);
}
public static function submitForSettlement($transactionId, $amount = null)
{
return Braintree_Configuration::gateway()->transaction()->submitForSettlement($transactionId, $amount);
}
public static function submitForSettlementNoValidate($transactionId, $amount = null)
{
return Braintree_Configuration::gateway()->transaction()->submitForSettlementNoValidate($transactionId, $amount);
}
public static function holdInEscrow($transactionId)
{
return Braintree_Configuration::gateway()->transaction()->holdInEscrow($transactionId);
}
public static function releaseFromEscrow($transactionId)
{
return Braintree_Configuration::gateway()->transaction()->releaseFromEscrow($transactionId);
}
public static function cancelRelease($transactionId)
{
return Braintree_Configuration::gateway()->transaction()->cancelRelease($transactionId);
}
public static function refund($transactionId, $amount = null)
{
return Braintree_Configuration::gateway()->transaction()->refund($transactionId, $amount);
}
}