1. Hi
@bummzack

2. SilverShop

3. What happened
• Rebranded as “SilverShop”
• 2.0 was released in July 2016
• Current version is 2.1
• Mark Guinn retired as a Maintainer

4. Core-features
• Shopping-Cart
• Categories, Products, Variations
• Checkout, either Single- or Multi-Step
• Guest-Checkout
• User-Accounts and Address-Book
• Supports a wide range of payment service providers via Omnipay

5. Features added via modules
• Stock-Management
• Discounts and Coupons
• Various Shipping-Methods
• Product-Search
• Colored-Variations
• AJAX functionality

6. Why use SilverShop?

8. Seriously though…

9. An example

20. SilverStripe & Omnipay

21. The Omnipay Library
• Framework agnostic payment library
• Provides a single API for many different payment service providers
• authorize, capture, purchase, refund, void
• 100% unit-tested

22. The Omnipay Architecture
• Payment API via Gateways
• Request/Response ≠ HTTP-Request/Response
• Omnipay is stateless

23. A simple example 1/3
composer require omnipay/paypal

24. A simple example 1/3
composer require omnipay/paypal
# purchase.php
require_once 'vendor/autoload.php';
use OmnipayOmnipay;
…

25. A simple example 1/3
composer require omnipay/paypal
# purchase.php
require_once 'vendor/autoload.php';
use OmnipayOmnipay;
$gateway = Omnipay::create('PayPal_Express');
…

26. A simple example 1/3
composer require omnipay/paypal
# purchase.php
require_once 'vendor/autoload.php';
use OmnipayOmnipay;
$gateway = Omnipay::create('PayPal_Express');
$gateway->initialize([
'username' => 'username.example.com',
'password' => '0123456789',
'signature' => 'AbUnchOFRandOMChaActeRS.muCHSiGnaTURe11101',
'testmode' => true
]);
…

27. A simple example 2/3
# … continued
$purchaseRequest = $gateway->purchase([
'amount' => '10.00',
'currency' => 'USD',
'returnUrl' => 'https://shop.example.com/completePurchase.php',
'cancelUrl' => 'https://shop.example.com/cancelPurchase.php'
]);
…

28. A simple example 2/3
# … continued
$purchaseRequest = $gateway->purchase([
'amount' => '10.00',
'currency' => 'USD',
'returnUrl' => 'https://shop.example.com/completePurchase.php',
'cancelUrl' => 'https://shop.example.com/cancelPurchase.php'
]);
$purchaseResponse = $purchaseRequest->send();
if ($purchaseResponse->isRedirect()) {
$purchaseResponse->redirect();
} else {
echo $purchaseResponse->getMessage();
}

30. A simple example 3/3
# completePurchase.php
$completePurchaseRequest = $gateway->completePurchase([
'amount' => '10.00',
'currency' => 'USD',
'returnUrl' => 'https://shop.example.com/completePurchase.php',
'cancelUrl' => 'https://shop.example.com/cancelPurchase.php'
]);
$completePurchaseResponse = $completePurchaseRequest->send();
if ($completePurchaseResponse->isSuccessful()) {
echo 'Payment complete!';
} else {
echo $completePurchaseResponse->getMessage();
}

31. The silverstripe-omnipay module

32. Features
• Provides a SilverStripe specific wrapper for omnipay
• Adds a persistence-layer (Payment DataObject)
• Provides URL endpoints for off-site payments
• Can be configured using the config API.

33. The architecture
• You create instances of Payment and use PaymentServices
that operate on these Payments.
• Services are commonly created through a ServiceFactory
• Payment Services map to the Omnipay API:
authorize, capture, purchase, refund, void

34. A simple example 1/3
composer require silverstripe/silverstripe-omnipay
composer require omnipay/paypal

35. A simple example 1/3
composer require silverstripe/silverstripe-omnipay
composer require omnipay/paypal
# mysite/_config/payment.yml
---
Name: payment-config
---
GatewayInfo:
PayPal_Express:
parameters:
username: 'username.example.com'
password: '0123456789'
signature: 'AbUnchOFRandOMChaActeRS.muCHSiGnaTURe11101'
testMode: true

36. A simple example 2/3
private static $allowed_actions = [
'purchase', 'completed', 'cancelled'];

37. A simple example 2/3
private static $allowed_actions = [
'purchase', 'completed', 'cancelled'];
public function purchase(){
$payment = Payment::create()
->init('PayPal_Express', 10, 'USD')
->setSuccessUrl($this->Link('completed'))
->setFailureUrl($this->Link('cancelled'));
…

38. A simple example 2/3
private static $allowed_actions = [
'purchase', 'completed', 'cancelled'];
public function purchase(){
$payment = Payment::create()
->init('PayPal_Express', 10, 'USD')
->setSuccessUrl($this->Link('completed'))
->setFailureUrl($this->Link('cancelled'));
$service = ServiceFactory::create()->getService(
$payment, ServiceFactory::INTENT_PURCHASE);
…

39. A simple example 2/3
private static $allowed_actions = [
'purchase', 'completed', 'cancelled'];
public function purchase(){
$payment = Payment::create()
->init('PayPal_Express', 10, 'USD')
->setSuccessUrl($this->Link('completed'))
->setFailureUrl($this->Link('cancelled'));
$service = ServiceFactory::create()->getService(
$payment, ServiceFactory::INTENT_PURCHASE);
$serviceResponse = $service->initiate();
return $serviceResponse->redirectOrRespond();
}

40. A simple example 3/3
https://shop.example.com/paymentendpoint/<hash>/complete
https://shop.example.com/mypaymentpage/completed

41. silverstripe-omnipay-ui module

43. Thanks!

44. Questions?