examples.md

Examples

The Example below shows parts of the code that you can put in your application.

CheckoutController

The controller below processes a submitted checkout, prepares the payment and returns the thank you page with the prepared payment request:

use Illuminate\Http\Request;
use Vanilo\Framework\Models\Order;
use Vanilo\Payment\Factories\PaymentFactory;
use Vanilo\Payment\Models\PaymentMethod;
use Vanilo\Payment\PaymentGateways;

class CheckoutController
{
    public function store(Request $request)
    {
        $order = Order::createFrom($request);
        $paymentMethod = PaymentMethod::find($request->get('paymentMethod'));
        $payment = PaymentFactory::createFromPayable($order, $paymentMethod);
        $gateway = PaymentGateways::make('braintree');
        $paymentRequest = $gateway->createPaymentRequest($payment, $order->getShippingAddress(), options: ['submitUrl' => route('payment.braintree.submit', $payment->hash)]);
        
        return view('checkout.thank-you', [
            'order' => $order,
            'paymentRequest' => $paymentRequest
        ]);
    }
}

checkout/thank-you.blade.php

This sample blade template contains a thank you page where you can render the payment initiation form:

Blade Template:

@extends('layouts.app')
@section('content')
    <div class="container">
        <h1>Thank you</h1>

        <div class="alert alert-success">Your order has been registered with number
            <strong>{{ $order->getNumber() }}</strong>.
        </div>

        <h3>Payment</h3>

        {!! $paymentRequest->getHtmlSnippet(); !!}
    </div>
@endsection

BraintreeReturnController

This is the controller and action where the submitUrl points to from the options array.

['submitUrl' => route('payment.braintree.submit', $payment->hash)]

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Vanilo\Payment\Models\Payment;
use Vanilo\Payment\PaymentGateways;
use Vanilo\Payment\Processing\PaymentResponseHandler;

class BraintreeReturnController extends Controller
{
    public function submit(Request $request, string $paymentId)
    {
        $gateway = PaymentGateways::make('braintree');
        $payment = Payment::findByPaymentId($paymentId);

        if (!$payment) {
            abort(404);
        }

        $response = $gateway->processPaymentResponse(
            $gateway->createTransaction($payment, $request->input('nonce'))
        );

        $handler = new PaymentResponseHandler($payment, $response);
        $handler->writeResponseToHistory();
        $handler->updatePayment();
        $handler->fireEvents();

        return view('payment.return', [
            'payment' => $payment,
            'order' => $payment->getPayable(),
        ]);
    }
}

Routes

The routes for Store should look like:

//web.php
Route::group(['prefix' => 'payment/braintree', 'as' => 'payment.braintree.'], function() {
    Route::post('{paymentId}/submit', 'BraintreeController@submit')->name('submit');
});

IMPORTANT!: Make sure to disable CSRF verification for these URLs, by adding them as exceptions to app/Http/Middleware/VerifyCsrfToken:

class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        '/payment/braintree/*'
    ];
}

Have fun!

---

Congrats, you've reached the end of this doc! 🎉