Add helper actions to easier execute common actions

[pierredup]

Add helper methods on the Payum class to make it easier to execute specific actions:

Capture

Capturing a payment

$response = $payum->capture($_REQUEST);

$response->send();

changes to capture.php script

- $token = $payum->getHttpRequestVerifier()->verify($_REQUEST);
- $gateway = $payum->getGateway($token->getGatewayName());
- 
- /** @var \Payum\Core\GatewayInterface $gateway */
- if ($reply = $gateway->execute(new Capture($token), true)) {
-     if ($reply instanceof HttpRedirect) {
-         header("Location: ".$reply->getUrl());
-         die();
-     } elseif ($reply instanceof HttpPostRedirect) {
-         echo $reply->getContent();
-         die();
-     }
- 
-     throw new \LogicException('Unsupported reply', null, $reply);
- }
- 
- /** @var \Payum\Core\Payum $payum */
- $payum->getHttpRequestVerifier()->invalidate($token);
- 
- header("Location: ".$token->getAfterUrl());
- 
+ 
+ $response = $payum->capture();
+
+ $response->send();

Done

Finishing a payment

$payment = $payum->done($_REQUEST);

assert($payment instanceof PaymentInterface);

changes to done.php script

- /** @var \Payum\Core\Payum $payum */
- $token = $payum->getHttpRequestVerifier()->verify($_REQUEST);
- $gateway = $payum->getGateway($token->getGatewayName());
- 
- $payum->getHttpRequestVerifier()->invalidate($token);
- $gateway->execute($status = new GetHumanStatus($token));
- $payment = $status->getFirstModel();
+ $payment = $payum->done($_REQUEST);

header('Content-Type: application/json');
echo json_encode([
    'order' => [
        'total_amount' => $payment->getTotalAmount(),
        'currency_code' => $payment->getCurrencyCode(),
        'details' => $payment->getDetails(),
    ],
]);

Notify

Receiving payment notification

$response = $payum->notify($_REQUEST);

$response->send()

changes to notify.php script

- $token = $payum->getHttpRequestVerifier()->verify($_REQUEST);
- $gateway = $payum->getGateway($token->getGatewayName());
- 
- try {
-     $gateway->execute(new Notify($token));
- 
-     http_response_code(204);
-     echo 'OK';
- } catch (HttpResponse $reply) {
-     foreach ($reply->getHeaders() as $name => $value) {
-         header("$name: $value");
-     }
- 
-     http_response_code($reply->getStatusCode());
-     echo ($reply->getContent());
- 
-     exit;
- } catch (ReplyInterface $reply) {
-     throw new \LogicException('Unsupported reply', null, $reply);
- }
+ $response = $payum->notify($_REQUEST);
+ 
+ $response->send()