pierrebelinfork / universignfork
PHP library for universign
1.2.0
2020-08-03 17:54 UTC
Requires (Dev)
- phpunit/phpunit: ^8
This package is not auto-updated.
Last update: 2024-10-02 07:10:52 UTC
README
This library is unofficial, not developed by Universign. It only contains usual functions used for Universign : send documents for signature, download it.
If you need help to implements this service on your website, feel free to contact me at : contact@pierrebelin.fr
This library is highly inspired by this one which is no longer maintain : https://github.com/globalis-ms/universign-service
How to use
You can copy-paste the following code and it will automatically connect you to your universign account.
Fill constants
$ACCOUNT_USER_MAIL = 'contact@pierrebelin.fr'; $ACCOUNT_USER_PASSWORD = 'xxxxxxxxx'; $UNIVERSIGN_PROFILE = 'default'; // you don't have to change this one, if you want to, read the manual
Get your document
$document = new TransactionDocument(); $document ->setContent(file_get_contents('path/to/file/file.pdf')) ->setName('Document name');
Create signature fields
$signatureField1 = new SignatureField(); $signatureField1->setPage(1) ->setX(50) ->setY(100);
Create signers
$signer = new TransactionSigner(); $signer ->setFirstname('Pierre') ->setLastname('Belin') ->setEmailAddress('contact@pierrebelin.fr') ->setPhoneNum('0606060606') ->setBirthDate('19900131T00:00:00') // This format is needed yyyymmddT00:00:00 as string for 31/01/1990 ->setSuccessURL('https://www.universign.eu/fr/sign/success/') ->setCancelURL('https://www.universign.eu/fr/sign/cancel/') ->setFailURL('https://www.universign.eu/fr/sign/failed/') ->addSignatureField($signatureField1); // you can add multiples times ->addSignatureField($signatureField2) etc...
Create transaction
$request = new TransactionRequest(); $request ->addSigner($signer) // you can add multiples times ->addSignatureField($signer2) etc... ->addDocument($document) // you can add multiples times ->addDocument($document2) etc... ->setProfile($UNIVERSIGN_PROFILE) ->setCustomId(uniqid()) // create your own ID to make easier to get later ->setMustContactFirstSigner(false) ->setFinalDocSent(true) ->setDescription("This is my description") ->setCertificateType(TransactionRequestCertificate::CERTIFICATE_CERTIFIED) ->setLanguage(TransactionRequestLanguage::FRENCH) ->setHandwrittenSignature(true) ->setChainingMode(TransactionRequestChainingMode::CHAINING_MODE_EMAIL);
Transaction request
$requester = new Requester($ACCOUNT_USER_MAIL, $ACCOUNT_USER_PASSWORD, false); $requester->requestTransaction($request);
Transaction response
$transactionId = $response->getId(); $transactionUrl = $response->getUrl();
Get documents
$response = $requester->getDocuments('TRANSACTIONID'); $response = $requester->getDocumentsByCustomId('CUSTOMID');
Send SEPA
Replace your document by :
$sepaFrom = new SEPAThirdParty(); $sepaFrom ->setName('from') ->setAddress('this address') ->setPostalCode('69001') ->setCity('Lyon') ->setCountry('France'); $sepaTo = new SEPAThirdParty(); $sepaTo ->setName('to') ->setAddress('to address') ->setPostalCode('69002') ->setCity('Lyon') ->setCountry('France'); $sepa = new SEPAData(); $sepa ->setIcs('XXXXXXXXXXXXX') ->setIban('FR7616798000010000191892XXXX') ->setBic('TRZOFR21XXX') ->setDebtor($sepaFrom) ->setCreditor($sepaTo); $document = new TransactionDocument(); $document ->setDocumentType(TransactionDocumentType::SEPA) ->setName('SEPA') ->setSEPAData($sepa);
Issues
Classes not found
Do not forget to include your autoload and all classes
require __DIR__ . '/vendor/autoload.php'; use PierreBelin\Universign\{ Request\TransactionDocument, Request\TransactionSigner, ... };