Update built-in routes, and clean up code

Author: glennraya

resources/views/checkout.blade.php

@@ -500,10 +500,6 @@ function chargeCard(auth_id, card_token) {
                     console.log('Executing payment...');
                     console.log('Authentication ID: ' + auth_id)
 
-                    // const csrfToken = document.querySelector('meta[name="csrf-token"]').getAttribute('content')
-
-                    // Make a POST request to the endpoint you specified where the
-                    // Xendivel::makePayment() will be executed.
                     axios.post('/pay-with-card', {
                         amount: document.getElementById('amount-to-pay').value,
                         token_id: card_token,

routes/xendivel-routes.php

@@ -2,6 +2,7 @@
 
 use App\Events\eWalletEvents;
 use GlennRaya\Xendivel\Invoice;
+use GlennRaya\Xendivel\Xendivel;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Route;
 
@@ -107,6 +108,55 @@
         return Invoice::make($invoice_data)
             ->download();
     });
+
+    // Example card charge, then send invoice to email as an attachment.
+    Route::post('/pay-with-card', function (Request $request) {
+        $payment = Xendivel::payWithCard($request)
+            ->getResponse();
+
+        return $payment;
+    });
+
+    // Example card charge, then send invoice to email as an attachment.
+    Route::post('/pay-with-card-email-invoice', function (Request $request) {
+        $invoice_data = [
+            'invoice_number' => 1000023,
+            'card_type' => 'VISA',
+            'masked_card_number' => '400000XXXXXX0002',
+            'merchant' => [
+                'name' => 'Stark Industries',
+                'address' => '152 Maple Avenue Greenfield, New Liberty, Arcadia USA 54331',
+                'phone' => '+63 971-444-1234',
+                'email' => 'xendivel@example.com',
+            ],
+            'customer' => [
+                'name' => 'Mr. Glenn Raya',
+                'address' => 'Alex Johnson, 4457 Pine Circle, Rivertown, Westhaven, 98765, Silverland',
+                'email' => 'victoria@example.com',
+                'phone' => '+63 909-098-654',
+            ],
+            'items' => [
+                ['item' => 'MacBook Pro 16" M3 Max', 'price' => $request->amount, 'quantity' => 1],
+            ],
+            'tax_rate' => .12,
+            'tax_id' => '123-456-789',
+            'footer_note' => 'Thank you for your recent purchase with us! We are thrilled to have the opportunity to serve you and hope that your new purchase brings you great satisfaction.',
+        ];
+
+        $payment = Xendivel::payWithCard($request)
+            ->emailInvoiceTo('glenn@example.com', $invoice_data)
+            ->send()
+            ->getResponse();
+
+        return $payment;
+    });
+
+    Route::post('/pay-via-ewallet', function (Request $request) {
+        $payment = Xendivel::payWithEWallet($request)
+            ->getResponse();
+
+        return $payment;
+    });
 }
 
 // Listen to webhook events from Xendit. This will fire up an event listener

src/Concerns/InvoicePathResolver.php

@@ -11,7 +11,7 @@ trait InvoicePathResolver
      * It will provide a default if none is provided.
      *
      * @param  string  $filename  Required. The filename of the invoice.
-     * @return string  Returns the PDF filename and the full path where the invoice was stored.
+     * @return string Returns the PDF filename and the full path where the invoice was stored.
      *
      * @throws Exception
      */

src/Invoice.php

@@ -27,9 +27,9 @@ class Invoice
     /**
      * Generate the invoice and save it to storage.
      *
-     * @param  array  $invoice_data [required]  The associative array of information to be displayed on the invoice.
-     * @param  string  $filename [optional]  The filename of the invoice. Will defaults to UUID v4 filename.
-     * @param  string  $template [optional]  The invoice blade template file.
+     * @param  array  $invoice_data  [required]  The associative array of information to be displayed on the invoice.
+     * @param  string  $filename  [optional]  The filename of the invoice. Will defaults to UUID v4 filename.
+     * @param  string  $template  [optional]  The invoice blade template file.
      */
     public static function make(array $invoice_data)
     {
@@ -75,7 +75,7 @@ public static function make(array $invoice_data)
      * will be deleted from storage, thereby saving
      * some space on the disk.
      *
-     * @throws Exception  if the file does not exists.
+     * @throws Exception if the file does not exists.
      */
     public function download(): BinaryFileResponse
     {
@@ -108,7 +108,7 @@ public function download(): BinaryFileResponse
     /**
      * Specify a different template for the invoice.
      *
-     * @param  string|null  $template [optional]  The filename for the invoice template.
+     * @param  string|null  $template  [optional]  The filename for the invoice template.
      */
     public function template(?string $template = null): self
     {

src/Mail/InvoicePaid.php

@@ -18,9 +18,9 @@ class InvoicePaid extends Mailable
     /**
      * Create a new message instance.
      *
-     * @param  GlennRaya\Xendivel\Invoice  $invoice_pdf [required] The invoice PDF.
-     * @param  mixed|null  $subject [optional] The subject of the email.
-     * @param  mixed|null  $message [optional] The email message.
+     * @param  GlennRaya\Xendivel\Invoice  $invoice_pdf  [required] The invoice PDF.
+     * @param  mixed|null  $subject  [optional] The subject of the email.
+     * @param  mixed|null  $message  [optional] The email message.
      * @return void
      */
     public function __construct(protected $invoice_pdf, public $subject = null, public $message = null)

src/Mail/RefundConfirmation.php

@@ -16,8 +16,8 @@ class RefundConfirmation extends Mailable
     /**
      * Create a new message instance.
      *
-     * @param  mixed|null  $subject [optional] The subject of the email.
-     * @param  mixed|null  $message [optional] The email message.
+     * @param  mixed|null  $subject  [optional] The subject of the email.
+     * @param  mixed|null  $message  [optional] The email message.
      * @return void
      */
     public function __construct(public $subject = null, public $message = null)

src/XenditApi.php

@@ -27,9 +27,9 @@ private static function generateAuthToken(): string
     /**
      * Perform Xendit API call.
      *
-     * @param  string  $method [required]  The type of HTTP request (post, get, etc).
-     * @param  string  $uri [required]  The URI for the request.
-     * @param  array  $payload [required]  The request payload for the API.
+     * @param  string  $method  [required]  The type of HTTP request (post, get, etc).
+     * @param  string  $uri  [required]  The URI for the request.
+     * @param  array  $payload  [required]  The request payload for the API.
      *
      * @throws Exception
      */

src/Xendivel.php

@@ -72,7 +72,7 @@ class Xendivel extends XenditApi
     /**
      * Make a payment request with the tokenized value of the card.
      *
-     * @param  Illuminate\Http\Requests  $payload [required]  The tokenized data of the card and other data.
+     * @param  Illuminate\Http\Requests  $payload  [required]  The tokenized data of the card and other data.
      */
     public static function payWithCard($payload): self
     {
@@ -118,8 +118,8 @@ public static function payWithCard($payload): self
     /**
      * Get the card or ewallet charge transaction by charge id.
      *
-     * @param  string  $charge_id [required]  The charge ID of the of the payment (card or ewallet).
-     * @param  string  $charge_type [required]   The type of payment method. Either card or ewallet.
+     * @param  string  $charge_id  [required]  The charge ID of the of the payment (card or ewallet).
+     * @param  string  $charge_type  [required]   The type of payment method. Either card or ewallet.
      */
     public static function getPayment(string $id, string $charge_type): self
     {
@@ -141,8 +141,8 @@ public static function getPayment(string $id, string $charge_type): self
     /**
      * Get the status and details of a specific eWallet refund by its refund ID.
      *
-     * @param  string  $charge_id [required]  The ID of the eWallet charge.
-     * @param  string  $refund_id [required]  The ID of the eWallet refund.
+     * @param  string  $charge_id  [required]  The ID of the eWallet charge.
+     * @param  string  $refund_id  [required]  The ID of the eWallet refund.
      */
     public static function getEwalletRefund(string $charge_id, string $refund_id): self
     {
@@ -158,7 +158,7 @@ public static function getEwalletRefund(string $charge_id, string $refund_id): s
     /**
      * Get the details of all eWallet refunds associated with a single eWallet charge identified by charge ID.
      *
-     * @param  string  $charge_id [required]  The eWallet charge ID.
+     * @param  string  $charge_id  [required]  The eWallet charge ID.
      */
     public static function getListOfEwalletRefunds(string $charge_id): self
     {
@@ -195,9 +195,9 @@ public static function payWithEwallet($payload): self
     /**
      * Request for a refund. Currently for cards and ewallet charge type.
      *
-     * @param  int  $amount [required]  The amount to be refunded. Can be partial amount.
-     * @param  string  $id [optional]  The external id provided by the user or auto provided.
-     * @param  string  $reason [optional]  The reason for the refund.
+     * @param  int  $amount  [required]  The amount to be refunded. Can be partial amount.
+     * @param  string  $id  [optional]  The external id provided by the user or auto provided.
+     * @param  string  $reason  [optional]  The reason for the refund.
      */
     public function refund(int $amount, ?string $id = null, ?string $reason = 'OTHERS'): self
     {
@@ -242,7 +242,7 @@ public function refund(int $amount, ?string $id = null, ?string $reason = 'OTHER
     /**
      * Void eWallet charge.
      *
-     * @param  string  $id [required]  The ID of the eWallet charge.
+     * @param  string  $id  [required]  The ID of the eWallet charge.
      */
     public static function void(string $id): self
     {
@@ -337,7 +337,7 @@ public function send(): self
     /**
      * Send refund confirmation e-mail to customer.
      *
-     * @param  string  $email [required]  The email address where the confirmation will be sent.
+     * @param  string  $email  [required]  The email address where the confirmation will be sent.
      */
     public function emailRefundConfirmationTo(string $email): self
     {

tests/Feature/XendivelFeatureTest.php

@@ -1,6 +1,5 @@
 <?php
 
-use GlennRaya\Xendivel\Xendivel;
 use Tests\TestCase;
 
 uses(TestCase::class);

tests/TestCase.php

@@ -15,5 +15,4 @@ protected function getPackageProviders($app)
             \GlennRaya\Xendivel\XendivelServiceProvider::class,
         ];
     }
-
 }