README

• Overview
• Features
• Installation
• Configuration
• Integration
• Testing

Overview

LaraPaymongo is a PayMongo integration with Laravel. Paymongo currently supports Credit/Debit Cards (Philippines only), GCash and GrabPay Payments. LaraPaymongo provides an easy way to integrate your Laravel website with Paymongo.

Features

• Ready-made Payment Pages and Purchase Button UI component
• Laravel routes, controllers views are ready-made - almost plug-and-play.
• Developers just need to define their application's logic before and after payments are made.

Installation

composer require peppertech/larapaymongo

Configuration

Environment variables

Integration

• Run the followign command to copy VueJS files and the LaraPaymongoIntegrator class to the main app

php artisan vendor:publish --tag="larapaymongo" --force

LaraPaymongoIntegrator class

The publish command will copy LaraPaymongoIntegrator in /app diectory. This class will contain the necessary logic of your application to be ran before and after payment is done by the user.

• updateTransactionSourceId() method is called by LaraPaymongo when Source ID needs to be save in database against the Transaction Reference ID (this could be the Order ID in your application).
• getTransactionDetails() method is called by LaraPaymongo when it needs the Transaction Details for the purchase. This method should query your database to retrive the information.
• completeTransaction() method is called by LaraPaymongo after the payment is successful.

Vue Components

Vue Components are copied from this package to your app in resources/js/components.

Ready-made Routes and Views

Here are the available routes and views for LaraPaymongo

• /payment/<referid> The Payment Page, where referid is the Transaction Reference ID.
• /payment/source/{method}/{referId} URL that gets called to generate a Source ID from Paymongo, when GCash/GrabPay payments are selected, where method can be gcash|grab_pay and referId is the Transaction Reference ID.
• /payment/verify/{paymentIntentId}, callback URL when Card Payment is successful. where paymentIntentId is Paymongo Payment Intent ID.
• /payment/details/{referId} callback URL for GCash and GrabPay payments. It can also be used to check the status of the Transaction.

IMPORTANT: The Views/payment.blade.php of this package extends from view/layouts.app of your app, so it should exist in your application's views.

Testing

• After Installation and Configuration, navigate to http://<your app domain>/payment/111, it should show the Payment Page.
• Use the Test Credit Card numbers from PayMongo Testing