Developer
# Clock
An implementation of the proposed PSR-20 clock-interface
[](https://packagist.org/packages/stella-maris/clock)
[](https://packagist.org/packages/stella-maris/clock)
[](https://packagist.org/packages/stella-maris/clock)
[](https://gitlab.com/stella-maris/clock/-/commits/main)
## Installation
```bash
composer require stella-maris/clock
```
## Usage
This interface allows one to inject one of the implemntations that provide the
clock-interface.
```php
use StellaMaris/Clock/CLockInterface;
final class PastChecker
{
public function __construct(private ClockInterface $clock) {}
public function hasDateTimeAlreadyPassed(DateTimeImmutable $item): bool
{
return $item < $this->clock->now();
}
}
```
## Why
Within the Framework Interoperability Group (FIG) a working group has started in 2021 to
create a ClockInterface. The works on that have been rather fast and already in the mid of
2021 the interface was more or less finally decided upon.
### So why this Interface?
Since mid 2021 no further work has been happening on the Working Group. All requests towards
the editor and the sponsor weren't met with any reaction.
So after a lot of discussions on the official working group channel I decided to bring this
interface forward by providing the currently agreed upon interface as a separate package
on packagist.
### But what when the PSR Interface is provided?
There are two possibilities:
* Either the interface will be provided by the FIG as it is currently,
then this interface will extend the PSR-20 one so that all implementations of this
interface will be immediately PSR20 compatible.
* Or the PSR20 interface will look different: Then all current implementations will
need to provide a spearate implementation for PSR20 compatibility and this interface will
simply coexist with the PSR20 one.
## Documentation
For a more thorough information about the interface please check the PSR-20 documentation
at https://github.com/php-fig/fig-standards/blob/master/proposed/clock.md and
https://github.com/php-fig/fig-standards/blob/master/proposed/clock-meta.md
Developer
Initiates a new payment transaction.
| Parameter | Type | Details |
|---|---|---|
| amount | decimal | Your Amount , Must be rounded at 2 precision. |
| currency | string | Currency Code, Must be in Upper Case (Alpha-3 code) |
| success_url | string | Enter your return or success URL |
| cancel_url | string (optional) | Enter your cancel or failed URL |
Request Example (guzzle)
<?php
require_once('vendor/autoload.php');
$client = new \GuzzleHttp\Client();
$response = $client->request('POST', $base_url.'create-order', [
'headers' => [
'Authorization' => 'Bearer '. $authorizationToken,
'accept' => 'application/json',
'content-type' => 'application/json',
],
'form_params' => [
'amount' => '$amount',
'currency' => 'currency',
'success_url' => 'success_url',
'cancel_url' => 'cancel_url',
],
]);
echo $response->getBody();
**Response: SUCCESS (200 OK)**
{
"message": {
"success": [
"Order created successfully."
]
},
"data": {
"redirect_url":"https://example.com/login/OISADFDFSDFSF",
"order_details":{
"amount" : "10",
"fixed_charge" : 2,
"percent_charge" : 1,
"total_charge" : 3,
"total_payable" : 13,
"currency" : "USD",
"expiry_time": "2024-04-25T06:48:35.984285Z",
"success_url": "http://127.0.0.1/nfcpay/user/transaction/success",
"cancel_url": "http://127.0.0.1/nfcpay/user/transaction/cancel"
}
},
"type": "success"
}
**Response: ERROR (400 FAILED)**
{
"message": {
"error": [
"Invalid token."
]
},
"data": null,
"type": "error"
}