2mindapps/laravel-pay-unity

Unified Payment and Subscription Processing in Laravel.

dev-master 2024-03-19 19:18 UTC

Requires

• php: ^7.3 || 8.*
• guzzlehttp/guzzle: ^7.8
• respect/validation: ^2.1

MIT

• Daniel Barcelos

• php
• payment
• gateway
• laravel

README

PayUnity

PHP library for centralizing payment gateway integrations, making API calls in a unified manner.

Installation:

Install this package with composer:

composer require 2mindapps/laravel-pay-unity

Feature comparison:

Gateway	Status	Available versions
Pagar.me	✅	v5
Mercado Pago	Developing	v1
PayPal	Coming soon	-
PagSeguro	Coming soon	-
Vindi	Coming soon	-

Methods by gateway:

Methods	Pagar.me (v5)	Mercado Pago (v1)
card()->get()	✅	✅
card()->create()	✅	✅
card()->delete()	✅	✅
customer()->get()	✅	✅
customer()->create()	✅	✅
customer()->update()	✅	✅
payment()->get()	✅	❌
payment()->createCreditCardTransaction()	✅	❌
payment()->createDebitCardTransaction()	❌	❌
payment()->createBankSlipTransaction()	❌	❌
payment()->createPixTransaction()	✅	❌
payment()->refundCreditCardTransaction()	✅	❌
payment()->getPayableFromPaidTransaction()	✅	❌
payment()->getPixInfoFromPixTransaction()	✅	❌
plan()->get()	✅	❌
plan()->create()	✅	❌
plan()->update()	✅	❌
plan()->delete()	✅	❌
postback()->handle()	✅	❌
postback()->getRefuseReasonByCode()	✅	❌
subscription()->get()	✅	❌
subscription()->create()	✅	❌
subscription()->updateCreditCard()	✅	❌
subscription()->updateMetadata()	✅	❌
subscription()->cancel()	✅	❌
subscription()->enableManualBilling()	✅	❌
subscription()->disableManualBilling()	✅	❌

Basic usage:

1. Instantiate the factory class by providing parameters such as the preferred gateway, gateway version, account environment and additional data (such as access token or secret key).

# Example instance for Pagar.me

$handler = new \MindApps\LaravelPayUnity\Factory('pagarme','v5','sandbox', ['secret_key' => 'MY_SCRET_KEY']);

1. Call the method according to the feature comparison table.

# Example for create customer

$data = (object) [
    'first_name' => 'Fulano',
    'last_name' => 'de Tal',
    'document_type' => 'cpf',
    'document_number' => '00011122233',
    'email' => '[e-mail]',
    'birth_date' => '1990-01-01',
    'address' => (object) [
        'street' => 'Av XYZ',
        'street_number' => '100',
        'neighborhood' => 'Centro',
        'zipcode' => '01100000',
        'city' => 'São Paulo',
        'state_code' => 'SP',
        'country_code' => 'BR',
    ],
    'phone' => (object) [
        'country_code' => '+55',
        'area_code' => '11',
        'number' => '999999999',
    ],
];

$handler->customer()
  ->create($data)
  ->send(); #execute this method to send data to Gateway API
  

Other examples is availables in Tests