| Server IP : 66.29.137.217 / Your IP : 3.22.194.224 Web Server : LiteSpeed System : Linux premium294.web-hosting.com 4.18.0-513.11.1.lve.el8.x86_64 #1 SMP Thu Jan 18 16:21:02 UTC 2024 x86_64 User : gltevjme ( 1095) PHP Version : 7.0.33 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : OFF | Pkexec : OFF Directory : /home/gltevjme/bofirmacademy.com/vendor/vrajroham/laravel-bitpay/src/Actions/ |
Upload File : |
<?php
namespace Vrajroham\LaravelBitpay\Actions;
use BitPaySDK\Exceptions\BitPayException;
use BitPaySDK\Model\Invoice\Buyer;
use BitPaySDK\Model\Invoice\Invoice;
use Vrajroham\LaravelBitpay\Constants\WebhookAutoPopulate;
trait ManageInvoices
{
/**
* Get BitPay Invoice instance.
*
* @link https://bitpay.com/api/#rest-api-resources-invoices-resource
*
* @param float|null $price float The amount for which the invoice will be created.
* @param string|null $currency string three digit currency code used to compute the invoice bitcoin amount.
*
* @return Invoice
*/
public static function Invoice(float $price = null, string $currency = null): Invoice
{
return new Invoice($price, $currency);
}
/**
* @return Buyer
*/
public static function Buyer(): Buyer
{
return new Buyer();
}
/**
* Create a BitPay invoice.
*
* @link https://bitpay.com/api/#rest-api-resources-invoices-create-an-invoice
*
* @param $invoice Invoice An Invoice object with request parameters defined.
*
* @return Invoice $invoice A BitPay generated Invoice object.
* @throws BitPayException BitPayException class
*/
public static function createInvoice(Invoice $invoice): Invoice
{
$thisInstance = new self();
try {
if (empty($invoice->getNotificationURL()) &&
in_array(WebhookAutoPopulate::For_Invoices, $thisInstance->config['auto_populate_webhook'])) {
$invoice->setNotificationURL(route('laravel-bitpay.webhook.capture'));
}
} catch (\Throwable $exception) {
// Misconfiguration or route macro not in use
}
return $thisInstance->client->createInvoice($invoice);
}
/**
* Retrieve a BitPay invoice by its id.
*
* @link https://bitpay.com/api/#rest-api-resources-invoices-retrieve-an-invoice
*
* @param $invoiceId string The id of the invoice to retrieve.
*
* @return Invoice A BitPay Invoice object.
* @throws BitPayException BitPayException class
*/
public static function getInvoice(string $invoiceId): Invoice
{
return (new self())->client->getInvoice($invoiceId);
}
/**
* Retrieve a collection of BitPay invoices.
*
* @link https://bitpay.com/api/#rest-api-resources-invoices-retrieve-invoices-filtered-by-query
*
* @param $dateStart string The start of the date window to query for invoices. Format YYYY-MM-DD.
* @param $dateEnd string The end of the date window to query for invoices. Format YYYY-MM-DD.
* @param $status string|null The invoice status you want to query on.
* @param $orderId string|null The optional order id specified at time of invoice creation.
* @param $limit int|null Maximum results that the query will return (useful for paging results).
* @param $offset int|null Number of results to offset (ex. skip 10 will give you results starting with the 11th result).
*
* @return Invoice[] A list of BitPay Invoice objects.
* @throws BitPayException BitPayException class
*/
public static function getInvoices(
string $dateStart,
string $dateEnd,
string $status = null,
string $orderId = null,
int $limit = null,
int $offset = null
): array {
return (new self())->client->getInvoices($dateStart, $dateEnd, $status, $orderId, $limit, $offset);
}
/**
* Request the last BitPay Invoice webhook to be resent.
*
* @link https://bitpay.com/api/#rest-api-resources-invoices-request-a-webhook-to-be-resent
*
* @param string $invoiceId The id of the invoice for which you want the last webhook to be resent.
*
* @return bool True if the webhook has been resent for the current invoice status, false otherwise.
* @throws \BitPaySDK\Exceptions\BitPayException BitPayException class
*/
public static function requestInvoiceWebhook(string $invoiceId): bool
{
return (new self())->client->requestInvoiceNotification($invoiceId);
}
}