Download the PHP package hval/nexi-php without Composer
On this page you can find all versions of the php package hval/nexi-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hval/nexi-php
More information about hval/nexi-php
Files in hval/nexi-php
Informations about the package nexi-php
hval/nexi-php
Unofficial PHP library for the Nexi XPay payment gateway: Hosted Payment Page (HPP), Pay-by-Link, recurring contracts, operations and webhooks.
Requirements
- PHP >= 7.2
- Any PSR-18 compatible HTTP client (e.g.
guzzlehttp/guzzle,symfony/http-client) - A PSR-7 / PSR-17 implementation (e.g.
nyholm/psr7,guzzlehttp/psr7)
Installation
Install a PSR-18 client if you don't already have one:
Quick Start
1. Instantiate the client
With Guzzle:
With Symfony HttpClient:
2. Create an order (HPP flow)
To attach customer details, pass a CustomerInfo object:
3. Handle the webhook
4. Refund, capture, cancel
Pass the operationId from the webhook notification (or from OrderResponse::getOperations()):
5. List orders and operations
6. Payment methods
7. Pay-by-Link
8. Recurring contracts
9. Recurring payments
Pass a Recurrence object as the last argument of PaymentSession to set up recurring payments:
Available actions: ACTION_NO_RECURRING, ACTION_SUBSEQUENT_PAYMENT, ACTION_CONTRACT_CREATION, ACTION_CARD_SUBSTITUTION.
Available contract types: CONTRACT_TYPE_MIT_UNSCHEDULED, CONTRACT_TYPE_MIT_SCHEDULED, CONTRACT_TYPE_CIT.
Response objects
For the full list of available getters on each response model, see docs/response-objects.md.
Exceptions
All exceptions extend NexiException, which can be used as a catch-all.
| Exception | When |
|---|---|
AuthenticationException |
401 — invalid API key |
InvalidRequestException |
400 — malformed request |
ApiException |
other 4xx / 5xx responses |
WebhookSignatureException |
security token mismatch |
Running Tests
Credits
- Hermann Vallieri
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of nexi-php with dependencies
ext-json Version *
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/http-message Version ^1.0|^2.0