A PayPal IPN (Instant Payment Notification) listener for PHP
- PHP >=7.1.0
- A good understanding of how the PayPal Instant Payment Notification system works (see here)
composer require mike182uk/paypal-ipn-listenerThis package is made up of several components that work together:
Listener- Listens for and processes the IPN messagesVerifier- Verifies the IPN message with PayPalService- Communicates with PayPalMessage- Wrapper around the IPN messageMessageFactory- Creates a new message instance from a data sourceEventDispatcher- Dispatches events
The listener creates a Message using a MessageFactory. The Message is passed to the Verifier which uses a Service to communicate with PayPal. The Listener uses the EventDispatcher to dispatch events relating to the outcome of the IPN message verification.
The MessageFactory and Service components are swappable components.
This package provides 2 message factories:
Mdb\PayPal\Ipn\MessageFactory\InputStreamMessageFactory- Creates a message from thephp://inputstreamMdb\PayPal\Ipn\MessageFactory\ArrayMessageFactory- Creates a message from an array passed to thesetDatamethod
This package provides 1 service:
Mdb\PayPal\Ipn\Service\GuzzleService- Uses Guzzle to communicate with PayPal
You can either build up the listener object manually or you can use a listener builder. This package provides 2 listener builders:
Mdb\PayPal\Ipn\ListenerBuilder\Guzzle\InputStreamListenerBuilder- Builds a listener using the guzzle service and the input stream message factoryMdb\PayPal\Ipn\ListenerBuilder\Guzzle\ArrayListenerBuilder- Builds a listener using the guzzle service and the array message factory
Using a listener builder is the preferred way of building up a listener object.
use Mdb\PayPal\Ipn\ListenerBuilder\Guzzle\InputStreamListenerBuilder as ListenerBuilder;
$listener = (new ListenerBuilder)->build();use GuzzleHttp\Client;
use Mdb\PayPal\Ipn\InputStream;
use Mdb\PayPal\Ipn\Listener;
use Mdb\PayPal\Ipn\MessageFactory\InputStreamMessageFactory;
use Mdb\PayPal\Ipn\Service\GuzzleService;
use Mdb\PayPal\Ipn\Verifier;
use Symfony\Component\EventDispatcher\EventDispatcher;
$service = new GuzzleService(
new Client(),
'https://www.sandbox.paypal.com/cgi-bin/webscr'
);
$verifier = new Verifier($service);
$messageFactory = new InputStreamMessageFactory(new InputStream());
$listener = new Listener(
$messageFactory,
$verifier,
new EventDispatcher()
);A lot of plumbing is needed to create the listener manually. The job of the listener builder is to abstract away this logic.
Once you have created the listener object you can subscribe to the events that it will dispatch:
use Mdb\PayPal\Ipn\Event\MessageVerifiedEvent;
use Mdb\PayPal\Ipn\Event\MessageInvalidEvent;
use Mdb\PayPal\Ipn\Event\MessageVerificationFailureEvent;
$listener->onVerified(function (MessageVerifiedEvent $event) {
$ipnMessage = $event->getMessage();
// IPN message was verified, everything is ok! Do your processing logic here...
});
$listener->onInvalid(function (MessageInvalidEvent $event) {
$ipnMessage = $event->getMessage();
// IPN message was was invalid, something is not right! Do your logging here...
});
$listener->onVerificationFailure(function (MessageVerificationFailureEvent $event) {
$error = $event->getError();
// Something bad happend when trying to communicate with PayPal! Do your logging here...
});You can use any callable when subscribing to an event:
class IpnProcessor
{
public function onVerified(MessageVerifiedEvent $event)
{
$message = $event->getMessage();
// ...
}
}
$listener->onVerified(array(new IpnProcessor, 'onVerified'));class IpnProcessor
{
public static function onVerified(MessageVerifiedEvent $event)
{
$message = $event->getMessage();
// ...
}
}
$listener->onVerified(array('IpnProcessor', 'onVerified'));The last thing you need to do to kick of the process is listen for an IPN message:
$listener->listen();use Mdb\PayPal\Ipn\Event\MessageVerifiedEvent;
use Mdb\PayPal\Ipn\Event\MessageInvalidEvent;
use Mdb\PayPal\Ipn\Event\MessageVerificationFailureEvent;
use Mdb\PayPal\Ipn\ListenerBuilder\Guzzle\InputStreamListenerBuilder as ListenerBuilder;
$listener = (new ListenerBuilder)->build();
$listener->onVerified(function (MessageVerifiedEvent $event) {
$ipnMessage = $event->getMessage();
// IPN message was verified, everything is ok! Do your processing logic here...
});
$listener->onInvalid(function (MessageInvalidEvent $event) {
$ipnMessage = $event->getMessage();
// IPN message was was invalid, something is not right! Do your logging here...
});
$listener->onVerificationFailure(function (MessageVerificationFailureEvent $event) {
$error = $event->getError();
// Something bad happend when trying to communicate with PayPal! Do your logging here...
});
$listener->listen();When using one of the provided listener builders you can set your listener to use PayPal's sandbox for testing purposes:
$listenerBuilder = new ListenerBuilder();
$listenerBuilder->useSandbox(); // use PayPal sandbox
$listener = $listenerBuilder->build();You can find some full usage examples in the examples directory.
To create your own service you must implement Mdb\PayPal\Ipn\Service.
To create your own message factory you must implement Mdb\PayPal\Ipn\MessageFactory.
To create your own listener builder it is best to extend Mdb\PayPal\Ipn\ListenerBuilder as this provides most of the boilerplate code needed to create a listener builder.
You will notice that when using any of the provided guzzle listener builders that there is a useSandbox method exposed. You can add this functionality to your listener builder by using the Mdb\PayPal\Ipn\ListenerBuilder\ModeDependentServiceEndpoint trait (see Mdb\PayPal\Ipn\ListenerBuilder\GuzzleListenerBuilder for usage example).
PayPal provides an IPN simulator here.
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent