PHP Класс Braintree\Transaction
At minimum, an amount, credit card number, and
credit card expiration date are required.
Minimalistic example:
Transaction::saleNoValidate(array(
'amount' => '100.00',
'creditCard' => array(
'number' => '5105105105105100',
'expirationDate' => '05/12',
),
));
Full example:
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' => '[email protected]',
'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'
)
)
== Storing in the Vault ==
The customer and credit card information used for
a transaction can be stored in the vault by setting
transaction[options][storeInVault] to true.
$transaction = 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'
To also store the billing address in the vault, pass the
addBillingAddressToPaymentMethod option.
Transaction.saleNoValidate(array(
...
'options' => array(
'storeInVault' => true
'addBillingAddressToPaymentMethod' => true
)
));
== Submitting for Settlement==
This can only be done when the transction's
status is
authorized. If
amount 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.
$transaction = Transaction::saleNoValidate(array(
'amount' => '100.00',
'creditCard' => array(
'number' => '5105105105105100',
'expirationDate' => '05/2012'
),
'options' => array(
'submitForSettlement' => true
)
));
== More information ==
For more detailed information on Transactions, see {@link http://www.braintreepayments.com/gateway/transaction-api http://www.braintreepaymentsolutions.com/gateway/transaction-api}
Показать файл
Открыть проект
Примеры использования класса
Открытые методы
Метод |
Описание |
|
__toString ( ) : string |
returns a string representation of the transaction |
|
cancelRelease ( $transactionId ) |
|
|
cloneTransaction ( $transactionId, $attribs ) |
static methods redirecting to gateway |
|
createFromTransparentRedirect ( $queryString ) |
|
|
createTransactionUrl ( ) |
|
|
credit ( $attribs ) |
|
|
creditNoValidate ( $attribs ) |
|
|
factory ( $attributes ) : Transaction |
factory method: returns an instance of Transaction
to the requesting method, with populated properties |
|
fetch ( $query, $ids ) |
|
|
find ( $id ) |
|
|
holdInEscrow ( $transactionId ) |
|
|
isDisbursed ( ) : boolean |
|
|
isEqual ( $otherTx ) |
|
|
refund ( $transactionId, $amount = null ) |
|
|
releaseFromEscrow ( $transactionId ) |
|
|
sale ( $attribs ) |
|
|
saleNoValidate ( $attribs ) |
|
|
search ( $query ) |
|
|
submitForPartialSettlement ( $transactionId, $amount, $attribs = [] ) |
|
|
submitForSettlement ( $transactionId, $amount = null, $attribs = [] ) |
|
|
submitForSettlementNoValidate ( $transactionId, $amount = null, $attribs = [] ) |
|
|
updateDetails ( $transactionId, $attribs = [] ) |
|
|
vaultCreditCard ( ) |
|
|
vaultCustomer ( ) : void | Braintree\Customer |
|
|
void ( $transactionId ) |
|
|
voidNoValidate ( $transactionId ) |
|
|
Защищенные методы
Метод |
Описание |
|
_initialize ( array $transactionAttribs ) : void |
sets instance properties from an array of values |
|
Описание методов
__toString()
публичный Метод
returns a string representation of the transaction
_initialize()
защищенный Метод
sets instance properties from an array of values
cancelRelease()
публичный статический Метод
cloneTransaction()
публичный статический Метод
static methods redirecting to gateway
createFromTransparentRedirect()
публичный статический Метод
createTransactionUrl()
публичный статический Метод
credit()
публичный статический Метод
public static credit ( $attribs ) |
creditNoValidate()
публичный статический Метод
factory()
публичный статический Метод
factory method: returns an instance of Transaction
to the requesting method, with populated properties
public static factory ( $attributes ) : Transaction |
Результат |
Transaction |
|
fetch()
публичный статический Метод
public static fetch ( $query, $ids ) |
find()
публичный статический Метод
public static find ( $id ) |
holdInEscrow()
публичный статический Метод
isDisbursed()
публичный Метод
isEqual()
публичный Метод
refund()
публичный статический Метод
public static refund ( $transactionId, $amount = null ) |
releaseFromEscrow()
публичный статический Метод
sale()
публичный статический Метод
public static sale ( $attribs ) |
saleNoValidate()
публичный статический Метод
search()
публичный статический Метод
public static search ( $query ) |
submitForPartialSettlement()
публичный статический Метод
submitForSettlement()
публичный статический Метод
submitForSettlementNoValidate()
публичный статический Метод
updateDetails()
публичный статический Метод
vaultCreditCard()
публичный Метод
vaultCustomer()
публичный Метод
void()
публичный статический Метод
public static void ( $transactionId ) |
voidNoValidate()
публичный статический Метод