tonystore / laravel-paymentez

v0.1.0 2024-12-27 19:00 UTC

Requires

• php: ^7.4|^8.0
• guzzlehttp/guzzle: ^7.4.2

Requires (Dev)

• orchestra/testbench: ^8.0
• phpunit/phpunit: ^10.0

MIT

• Anthony Medina

Published on Packagist.org on 2024-12-27 19:15 UTC

README

Esta librería de Laravel permite integrarse fácilmente con las APIs de Paymentez, proporcionando una forma sencilla de realizar operaciones como pagos, consultas de transacciones, entre otras.

Instalación y Configuración

1. Instala la librería usando Composer:

   composer require tonystore/laravel-paymentez

1. Publica el archivo de configuración ejecutando:

  php artisan vendor:publish --provider="TonyStore\LaravelPaymentez\LaravelPaymentezProvider"

Esto generará un archivo config/paymentez.php donde podrás ajustar las configuraciones.

1. Agrega las siguientes variables a tu archivo .env:

PAYMENTEZ_API_CODE=your-auth-code
PAYMENTEZ_API_KEY=your-auth-key

• PAYMENTEZ_API_CODE: Código de autenticación proporcionado por Paymentez.
• PAYMENTEZ_API_KEY: Llave de autenticación para conectarse a las APIs.

1. Ejemplo de archivo de configuración generado (config/paymentez.php):

<?php 

return [
    'auth_code' => env('PAYMENTEZ_API_CODE', ''),

    'auth_key' => env('PAYMENTEZ_API_KEY', ''),

    'base_url' => [
        'ccapi' => env('PAYMENTEZ_CCAPI_URL'),
        'noccapi' =>  env('PAYMENTEZ_NOCCAPI_URL')
    ],
];

Recursos disponibles:

• PaymentezCard: getList, delete
• PaymentezCharge: create, authorize, capture, verify, refund

Formas de uso

Obtener una lista de tarjetas por usuario

<?php 
use TonyStore\LaravelPaymentez\Facades\PaymentezCard;


$uid = '23';
$cards = PaymentezCard::getList($uid);

Eliminar una tarjeta con token

<?php 
use TonyStore\LaravelPaymentez\Facades\PaymentezCard;


$uid = '23';
$token = '785896526632'
PaymentezCard::delete($token, ["id" => (string)$uid]);

Crear nuevo cargo con token

<?php 
use TonyStore\LaravelPaymentez\Facades\PaymentezCard;


$cardToken = "myAwesomeTokenCard";

$userDetails = [
    'id' => "23", 
    'email' => "[e-mail]" 
];

$orderDetails = [
    'amount' => 100.00, 
    'description' => "XXXXXX",
    'dev_reference' => "XXXXXX", 
    'vat' => 0.00 
];

$created = PaymentezCharge::create($cardToken, $orderDetails, $userDetails);

$object = $created->toObject(); //Obtener la respuesta en formato objeto simple
$collection = $created->toCollection(); //Obtener la respuesta en una colección
$array = $created->toArray(); //Obtener la respuesta en un arreglo
$response = $created->toResponse(); // Obtener instancia de Response

// Obtener información de la respuesta

// Estado
$status = $object->transaction->status;

// Id de la transacción
$transactionId = $object->transaction->id;