Download the PHP package balerka/laravel-payhub without Composer

Laravel Payhub

Reusable payment foundation for Laravel applications.

It provides:

• Laravel models for cards, orders, transactions, and subscriptions.
• Migrations and configurable table names.
• Auth-protected JSON endpoints for custom frontends.
• Embeddable React components for checkout and payment card management.
• A local test payment endpoint for development.

Install

For local development from this repository:

Then run:

Frontend Components

Payhub does not register checkout or cards page routes. Publish the React assets and embed the exported components in your own pages:

The React files publish to:

Example:

Basic usage:

Payhub does not manage products or catalogs. Your application owns product selection and passes payment details into Checkout:

• amount - required payment amount
• currency - optional ISO currency code, defaults to PAYHUB_CURRENCY
• description - optional text sent to the gateway
• receipt - optional full receipt object with items, email, amounts, currency, description, and any gateway-specific receipt data
• items - shorthand for receipt.items if you do not need to pass the full receipt object

Payhub ships with embedded English and Russian dictionaries inside the published React files, so the component can pick its own translations from locale without touching host project files.

Translations

If the host project wants to reuse the same strings in its own i18n system, publish the standalone dictionaries too:

This creates:

Payhub does not edit host project files. The host app can either:

• let the components localize themselves from locale
• import payhub.json directly and pass messages overrides when needed
• load payhub.json into its own i18n system if it already has one
• do nothing and use the built-in English fallback messages

Checkout example:

Override example:

Routes

Routes are registered with the payhub. name prefix and use /payhub as the default URL prefix:

• GET /payhub/cards/data returns cards as JSON.
• GET /payhub/checkout/data returns gateway metadata and saved cards as JSON.
• POST /payhub/checkout/orders creates a pending order from amount, currency, description, and optional receipt. Payhub stores the full receipt object on the order. When card_id is passed with the cloud_payments gateway, Payhub charges that saved card token through CloudPayments.
• DELETE /payhub/checkout/orders/{order} cancels a pending order.
• PUT /payhub/cards/default sets the default card.
• DELETE /payhub/cards/{card} deletes a card owned by the current user.
• GET /payhub/subscriptions/data returns subscriptions owned by the current user.
• POST /payhub/subscriptions/cancel cancels a current user's CloudPayments subscription.
• GET /payhub/refunds/data returns refundable payment transactions owned by the current user.
• POST /payhub/refunds/refund refunds or voids a current user's CloudPayments payment transaction.
• POST /payhub/payments/test/pay creates a local test payment when payhub.test_mode=true.

For checkout, cards, subscriptions, and refunds UI, publish the React assets and embed Checkout, PaymentCards, PayhubSubscriptions, or PayhubRefunds in any application page. Payhub does not register page routes for these components. For a custom frontend, call the JSON endpoints directly and send Accept: application/json when you want JSON responses from mutation endpoints.

Configuration

config/payhub.php controls route middleware, table names, user model, currency, test mode, and gateway metadata.

Set checkout currency with:

Select the active gateway with:

The published checkout component supports the test gateway and CloudPayments widget flow. When the current user has saved cards, the checkout component lists them, selects the default card, and sends the selected card_id for saved-card payment. Users can still choose a new-card payment, which opens the CloudPayments widget.

For CloudPayments:

Configure CloudPayments callbacks to:

The callbacks are protected with the CloudPayments Content-HMAC signature.

To reuse the table names from an existing app, set:

Only PAYHUB_* environment variables are supported.