Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hexters/coinpayment
Package to handle payment of cryptocurrency
https://github.com/hexters/coinpayment
cryptocurrency
Last synced: 2 days ago
JSON representation
Package to handle payment of cryptocurrency
- Host: GitHub
- URL: https://github.com/hexters/coinpayment
- Owner: hexters
- License: mit
- Created: 2018-03-23T07:17:11.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-05-31T09:05:52.000Z (over 1 year ago)
- Last Synced: 2025-01-29T07:08:51.431Z (9 days ago)
- Topics: cryptocurrency
- Language: JavaScript
- Homepage: https://www.coinpayments.net/index.php?ref=3dc0c5875304cc5cc1d98782c2741cb5
- Size: 7.91 MB
- Stars: 73
- Watchers: 6
- Forks: 42
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CoinPayments v3
[](https://packagist.org/packages/hexters/coinpayment)
[](https://packagist.org/packages/hexters/coinpayment)
[](https://packagist.org/packages/hexters/coinpayment)
## Coinpayment Laravel Package
[](https://www.coinpayments.net/index.php?ref=3dc0c5875304cc5cc1d98782c2741cb5)
CoinPayment is a Laravel package for handling transactions from [CoinPayment](https://www.coinpayments.net/index.php?ref=3dc0c5875304cc5cc1d98782c2741cb5) like a create transaction, history transaction, etc.
### Version support
| version | laravel |
|-|-|
|[v1.1.3](https://github.com/hexters/CoinPayment/releases/tag/v1.1.3)|5.6|
|[v2.0.0](https://github.com/hexters/CoinPayment)|5.8|
|[v2.0.3](https://github.com/hexters/CoinPayment)|6.x|
|[Current Version](https://github.com/hexters/CoinPayment)|^8.x|
## Installation
You can install this package via composer:
```bash
$ composer require hexters/coinpayment
```
Publishing vendor
```bash
$ php artisan vendor:publish --tag=coinpayment
```
Install CoinPayment configuration
```bash
$ php artisan coinpayment:install
```
Installation finish.
## Getting Started
Create Button transaction. Example placed on your controller
```php
use Hexters\CoinPayment\CoinPayment;
. . .
/*
* @required true
*/
$transaction['order_id'] = uniqid(); // invoice number
$transaction['amountTotal'] = (FLOAT) 37.5;
$transaction['note'] = 'Transaction note';
$transaction['buyer_name'] = 'Jhone Due';
$transaction['buyer_email'] = '[email protected]';
$transaction['redirect_url'] = url('/back_to_tarnsaction'); // When Transaction was comleted
$transaction['cancel_url'] = url('/back_to_tarnsaction'); // When user click cancel link
/*
* @required true
* @example first item
*/
$transaction['items'][] = [
'itemDescription' => 'Product one',
'itemPrice' => (FLOAT) 7.5, // USD
'itemQty' => (INT) 1,
'itemSubtotalAmount' => (FLOAT) 7.5 // USD
];
/*
* @example second item
*/
$transaction['items'][] = [
'itemDescription' => 'Product two',
'itemPrice' => (FLOAT) 10, // USD
'itemQty' => (INT) 1,
'itemSubtotalAmount' => (FLOAT) 10 // USD
];
/*
* @example third item
*/
$transaction['items'][] = [
'itemDescription' => 'Product Three',
'itemPrice' => (FLOAT) 10, // USD
'itemQty' => (INT) 2,
'itemSubtotalAmount' => (FLOAT) 20 // USD
];
$transaction['payload'] = [
'foo' => [
'bar' => 'baz'
]
];
return CoinPayment::generatelink($transaction);
. . .
```
## Listening status transaction
Open the Job file `App\Jobs\CoinpaymentListener` for the listen the our transaction and proccess
## Manual check without IPN
This function will execute orders without having to wait for the process from IPN
We can also make cron to run this function if we don't use IPN
```php
use Hexters\CoinPayment\CoinPayment;
. . .
/**
* this is triger function for running Job proccess
*/
return CoinPayment::getstatusbytxnid("CPDA4VUGSBHYLXXXXXXXXXXXXXXX");
// output example: "celled / Timed Out"
```
## Get histories transaction Eloquent
```php
use Hexters\CoinPayment\CoinPayment;
. . .
CoinPayment::gettransactions()->where('status', 0)->get();
```
# IPN Route
Except this path `/coinpayment/ipn` into csrf proccess in `App\Http\Middleware\VerifyCsrfToken`
```php
. . .
/**
* The URIs that should be excluded from CSRF verification.
*
* @var array
*/
protected $except = [
'/coinpayment/ipn'
];
. . .
```
# Promote New Features
Now you can integrate you coinpayment transaction with [**Ladmin (Laravel Admin scaffolding)**](https://github.com/hexters/ladmin). You just buy for the package price starting at **$ 36.25** per version.
### What is the features?
- List of the transaction from CoinPayment base on database
- Create new transaction from admin page & send to buyer email
- You can Check status of transaction via admin page manually
- Remove pending transaction
- List of CoinPayment Balance
- Top Up balance
- Easy and quick Installation
For details source visit the pakcage [**Ladmin CoinPayment**](https://ppmarket.org/browse/hexters-ladmin-coinpayment)
# Troubleshooting
## Cannot use object of type Illuminate\Http\JsonResponse as array
Visit the [**CoinPayment API Keys**](https://www.coinpayments.net/index.php?cmd=acct_api_keys) page, under *Actions*, click on the *Edit Permissions* button. Enter the IP address of your API endpoint (e.g. your website server) in the *Restrict to IP/IP Range* input. Leaving it empty, may cause this error to occur.
# Supporting the project
You can support the maintainer of this project through the referral links below
- [**Sign up for DigitalOcean**](https://www.digitalocean.com/?refcode=36844cd4f4b4&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=badge)
- [**PayPal**](https://paypal.me/asepss19)