mothership-ec/cog-mothership-ecommerce

Cog module for processing E-Commerce in Mothership

Wednesday, March 23, 2016
by thomasjthomasj
Repository
6 Watchers
2 Stars
1,761 Installations

PHP
4 Dependents
0 Suggesters
2 Forks
56 Open issues
96 Versions
0 % Grown

The README.md

Mothership Ecommerce

Configuration

Dispatch

printer-name: ...

Payment

gateway: Name of gateway to use. Note the gateway must be available to the system.
use-test-payments: Use the test environment of external payment gateways.
salt: Used when hashing data in the payment processes.

Gateways

Payment gateways allow you to process payments through an external service., _(*1)

There are two components to a gateway within mothership; an implementation of Gateway\GatewayInterface to communicate with the external service, and controllers to handle purchase and refund requests., _(*2)

Default gateways

ZeroPayment

The zero payment gateway is the most basic implementation, it simply completes the order and redirects straight to the success url., _(*3)

LocalPayment

The local payment gateway is an extension of zero payment., _(*4)

Extending with new gateway providers

To add a new gateway provider you'll need to create a new adapter that implements Gateway\GatewayInterface and append it to the gateway.collection service., _(*5)

Secondly you'll need to implement the Controllers\Gateway\PurchaseControllerInterface and Controllers\Gateway\RefundControllerInterface. If your new gateway does not support refunds then the refund() method should just return $this->createNotFoundException()., _(*6)

Of course your gateway and controller(s) can use additional methods for handling the specific functionality and process flow for the new provider, such as callbacks from the external service., _(*7)

Purchases

A purchase process is a system which sends a payment request to a gateway and creates / modifies an object on a success response and reacts accordingly to cancelled and failed purchases. For example, the standard checkout process which on success saves the order to the database and records the payment against it., _(*8)

When writing a new purchase process the 'continue to payment' action should forward the request to the current gateway's purchase controller reference using $this->get('gateway')->getPurchaseControllerReference()., _(*9)

This forward request should pass the instance of PayableInterface that is being purchased and the stages configuration., _(*10)

$controller = 'Message:Mothership:Foo::Controller:Bar';
return $this->forward($this->get('gateway')->getPurchaseControllerReference(), [
    'payable' => $instanceOfPayableInterface,
    'stages'  => [
        'cancel'  => $controller . '#cancel',  // Method for reacting to cancelled purchases
        'failure' => $controller . '#failure', // Method for reacting to failed purchases
        'success' => $controller . '#success', // Method for reacting to successful purchases
    ]
]);

The purchase process requires a controller that implements Controllers\Gateway\CompleteControllerInterface. This should implement the success, cancel and failure methods., _(*11)

The success() method should turn the payable into a saved instance of the object it represents, e.g. an order, store any payments as necessary and return a success url in a JsonResponse. This completion process should be called by the gateway purchase controller when confirming the purchase with the external provider., _(*12)

Refunds

A refund process works in the same way as a purchase purchase, except you forward the request to $this->get('gateway')->getRefundControllerReference() and pass an additional reference parameter. The cancel stage is not required for refunds., _(*13)

$controller = 'Message:Mothership:Foo::Controller:Bar';
return $this->forward($this->get('gateway')->getRefundControllerReference(), [
    'payable'   => $instanceOfPayableInterface,
    'reference' => 'reference for the payment made previously being refunded',
    'stages'    => [
        'failure' => $controller . '#failure', // Method for reacting to failed refunds
        'success' => $controller . '#success', // Method for reacting to successful refunds
    ]
]);

The Versions

23/03 2016

dev-develop

dev-develop http://mothership.ec

Cog module for processing E-Commerce in Mothership

library cog-mothership-ecommerce

Cog module for processing E-Commerce in Mothership

mothership-ec/cog-mothership-ecommerce

The README.md

Mothership Ecommerce

Configuration

Dispatch

Payment

Gateways

Default gateways

ZeroPayment

LocalPayment

Extending with new gateway providers

Purchases

Refunds

The Versions

dev-develop

The Requires

The Development Requires

by The Mothership Development Team

dev-master

The Requires

The Development Requires

by The Mothership Development Team

3.8.0

The Requires

The Development Requires

by The Mothership Development Team

3.7.3

The Requires

The Development Requires

by The Mothership Development Team

dev-feature/validate-email

The Requires

The Development Requires

by The Mothership Development Team

3.7.2

The Requires

The Development Requires

by The Mothership Development Team

3.7.1

The Requires

The Development Requires

by The Mothership Development Team

3.7.0

The Requires

The Development Requires

by The Mothership Development Team

3.6.1

The Requires

The Development Requires

by The Mothership Development Team

3.6.0

The Requires

The Development Requires

by The Mothership Development Team

3.5.1

The Requires

The Development Requires

by The Mothership Development Team

dev-fulfillment-button-fix

The Requires

The Development Requires

by The Mothership Development Team

3.5.0

The Requires

The Development Requires

by The Mothership Development Team

3.4.0

The Requires

The Development Requires

by The Mothership Development Team

3.3.1

The Requires

The Development Requires

by The Mothership Development Team

3.3.0

The Requires

The Development Requires

by The Mothership Development Team