Login and Pay with Amazon
Didn't like the official amazon package so i made this one. Its much lighter and easier to setup. I'm using this in production on a ecommerce site and it works well., (*1)
Installation
Install through Composer., (*2)
composer require tuurbo/amazon-payment
Laravel 4 or 5 Setup
Next, update app/config/app.php to include a reference to this package's service provider in the providers array and the facade in the aliases array., (*3)
'providers' => [
'Tuurbo\AmazonPayment\AmazonPaymentServiceProvider'
]
'aliases' => [
'AmazonPayment' => 'Tuurbo\AmazonPayment\AmazonPaymentFacade'
]
add to the app/config/services.php config file., (*4)
[
'sandbox_mode' => true,
'store_name' => 'ACME Inc',
'statement_name' => 'AcmeInc 555-555-5555',
'client_id' => '',
'seller_id' => '',
'access_key' => '',
'secret_key' => '',
]
];
```
### Native Setup
```php
true,
'client_id' => '',
'seller_id' => '',
'access_key' => '',
'secret_key' => '',
'store_name' => 'ACME Inc',
'statement_name' => 'AcmeInc 555-555-5555'
];
$amazonPayment = new Tuurbo\AmazonPayment\AmazonPayment(
new Tuurbo\AmazonPayment\AmazonPaymentClient(
new GuzzleHttp\Client, $config
),
$config
);
try {
$response = $amazonPayment->setOrderDetails(...);
} catch (\Exception $e) {
// catch errors
}
```
## Two Scenario's
Each step below represents a page on your site.
```
// User logs in. // User already logged in, amazon auto redirects to Checkout.
1. Login ---------> Cart ----------> Checkout
// User isn't logged in, amazon asks them to login, then redirects to Checkout.
2. Cart ----------> Checkout
```
## Example Usage (Scenario 1):
User is redirected to amazon when they click the Amazon Login button, then to your sites login page.
Login View example:
```html
Login Controller: GET -> http://example.com/login, (*5)
first();
// Update and login Amazon user
if ($user) {
$validator = Validator::make([
'email' => $amazon['email'],
], [
'email' => 'unique:user,email,'.$user->id,
]);
$user->last_login = new Datetime;
// update their current amazon email
if ($validator->passes()) {
$user->email = $amazon['email'];
}
$user->save();
Auth::loginUsingId($user->id);
return Redirect::intended('/account');
}
// if they dont have an amazon linked account,
// check if there amazon email is already taken
$user = \User::where('email', $amazon['email'])->first();
// email address is already taken
// this is optional if you only except amazon logins
if ($user) {
// redirect to a page to link their amazon account
// to their non-amazon account that they already have on your site.
// example...
$credentials = Crypt::encrypt(json_encode([
'amazon_id' => $amazon['user_id'],
'amazon_email' => $amazon['email'],
]));
// redirect and then decrypt the data and make them put in the their non-amazon password to merge their amazon account.
return Redirect::to('/register/connect-amazon/'.$credentials);
}
} catch (\Exception $e) {
Session::forget('amazon');
return Redirect::to('/login')
->with('failure_message', 'There was an error trying to login with your Amazon account.');
}
// If no user already exists, create a new amazon user account
$user = new \User;
$user->amazon_id = $amazon['user_id'];
$user->email = $amazon['email'];
$user->name = $amazon['name'];
$user->signup_at = 'normal amazon account';
$user->save();
Auth::user()->loginUsingId($user->id);
return Redirect::intended('/account');
}
```
continue to scenario 2 for Amazon Checkout...
## Example Usage (Scenario 2):
User is redirected to amazon when they click the Amazon Pay button, then back to your sites checkout page.
Shopping Cart: `GET -> http://example.com/cart`
```html
After the user logs into Amazon, Amazon redirects them back to your site., (*6)
Amazon Checkout Controller: GET -> http://example.com/amazon/checkout, (*7)
with('failure_message', 'Failed to connect to your Amazon account. Please try again.');
}
// Laravel Auth example:
// login user if their Amazon user_id is found in your users table
// Obviously for this to work, you would have created the user entry at some other point in your app, maybe the account register page or something
$user = User::where('amazon_id', $amazonUser['user_id'])->first();
// If user is found, log them in
if ($user) {
Auth::loginUsingId($user->id);
}
return View::make(...);
```
Amazon Checkout View example:
```html
<input type="hidden" name="access_token" value="<?= $_GET['access_token'] ?>">
<input type="hidden" name="reference_id" id="reference_id">
Create the users order after they submit it., (*8)
Amazon Checkout Controller: POST -> http://example.com/checkout, (*9)
<?php
// If using Laravel "Input::get('...')" can be used in place of "$_POST['...']"
// get access token
$accessToken = $_POST['access_token'];
// get amazon order id
$amazonReferenceId = $_POST['reference_id'];
try {
// get user details
$amazonUser = AmazonPayment::getLoginDetails($accessToken);
} catch (\Exception $e) {
// Redirect back to cart page if error
return Redirect::to('/cart')
->with('failure_message', 'Failed to connect to your Amazon account. Please try again.');
}
// (optional) Wrap your Order transaction with the below code to revert the order if the amazon payment fails.
// DB::beginTransaction();
// create customers order
$order = new Order;
$order->email = $amazonUser['email'];
$order->amazon_id = $amazonReferenceId;
$order->grand_total = 109.99;
$order->etc...
$order->save();
try {
// set amazon order details
AmazonPayment::setOrderDetails([
'referenceId' => $amazonReferenceId,
'amount' => 109.99,
'orderId' => $order->id,
// optional note from customer
'note' => $_POST['note']
]);
// comfirm the amazon order
AmazonPayment::confirmOrder([
'referenceId' => $amazonReferenceId,
]);
// get amazon order details and
// save the response to your customers order
$amazon = AmazonPayment::getOrderDetails([
'referenceId' => $amazonReferenceId,
]);
$address = $amazon['details']['Destination']['PhysicalDestination'];
// Update the order address, city, etc...
$order->shipping_city = $address['City'];
$order->shipping_state = $address['StateOrRegion'];
$order->save();
// log error.
// tell customer something went wrong.
// maybe delete `$order->delete()` or rollback `DB::rollback();` your websites internal order in the database since it wasn't approved by Amazon
} catch (\Tuurbo\AmazonPayment\Exceptions\OrderReferenceNotModifiableException $e) {
// DB::rollback();
return Redirect::to('/secure/cart')->with('warning_message', 'Your order has already been placed and is not modifiable online. Please call '.config('site.company.phone').' to make changes.');
} catch (\Exception $e) {
// DB::rollback();
return Redirect::to('/secure/cart')->with('warning_message', 'There was an error with your order. Please try again.');
}
// DB::commit();
// other checkout stuff...
Example response from AmazonPayment::getOrderDetails(), (*10)
{
"details": {
"AmazonOrderReferenceId": "SXX-XXXXXXX-XXXXXXX",
"ExpirationTimestamp": "2015-01-29T22:35:40.555Z",
"OrderTotal": {
"Amount": "4637.43",
"CurrencyCode": "USD"
},
"Destination": {
"DestinationType": "Physical",
"PhysicalDestination": {
"PostalCode": "60602",
"CountryCode": "US",
"StateOrRegion": "IL",
"City": "Chicago"
}
},
"OrderReferenceStatus": {
"State": "Draft"
},
"ReleaseEnvironment": "Sandbox",
"SellerOrderAttributes": {
"StoreName": "ACME Inc",
"SellerOrderId": "12345"
},
"CreationTimestamp": "2014-08-02T22:35:40.555Z"
},
"requestId": "12345678-557f-6ae2-a2ab-ef6db5a325a2"
}
Available Methods
<?php
AmazonPayment::setOrderDetails()
AmazonPayment::getOrderDetails()
AmazonPayment::confirmOrder()
AmazonPayment::authorize()
AmazonPayment::authorizeAndCapture()
AmazonPayment::capture()
AmazonPayment::closeOrder()
AmazonPayment::cancelOrder()
AmazonPayment::refund()
AmazonPayment::login()
AmazonPayment::getLoginDetails()
AmazonPayment::script()
Amazon docs: http://docs.developer.amazonservices.com/en_US/apa_guide/APAGuide_Introduction.html, (*11)
Wallogit.com
