-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
130 lines (95 loc) · 4.39 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
CONTENTS OF THIS FILE
---------------------
* Introduction
* Requirements
* Recommended modules
* Installation
* Configuration
* Troubleshooting
* FAQ
* Maintainers
INTRODUCTION
------------
The MultiSafepay Payment module allows the interaction with payment
systems provided by MultiSafepay. In addition to defining two submodules
that integrate with Drupal Commerce and Ubercart, it provides a simple
infrastructure to define the plugin associated with the payment method,
to be used to construct the vector data to send to server MultiSafepay
and to manage the payment notification or redirects the user to the site
from the payment pages of MultiSafepay.
* For a full description of the module, visit the project page:
https://github.com/lucacracco/multisafepay_payment
* To submit bug reports and feature suggestions, or to track changes:
https://github.com/lucacracco/multisafepay_payment/issues
REQUIREMENTS
------------
This module requires the following modules:
* Payment (https://www.drupal.org/project/payment) >=1.8
* Libraries API (https://www.drupal.org/project/libraries)
* Entity API (https://www.drupal.org/project/entity)
For submodule MultiSafepay Payment Commerce:
* Payment for Drupal Commerce (https://www.drupal.org/project/payment_commerce)
For submodule MultiSafepay Payment Ubercart:
* Payment for Ubercart (https://www.drupal.org/project/payment_ubercart)
RECOMMENDED MODULES
-------------------
Nothing.
INSTALLATION
------------
* Download libraries 'MultiSafepay PHP' from https://github.com/MultiSafepay/PHP.
Extract zip and rename folder in 'multisafepay_php'. Copy libraries folder in
Drupal libraries folder (es. /sites/all/libraries/).
At the end you should have /sites/all/libraries/multisafepay_php/models/API/Object/Core.php
for example.
* Install as you would normally install a contributed Drupal module. See:
https://drupal.org/documentation/install/modules-themes/modules-7
for further information.
* Creates the payment method following the instructions of module Payment.
CONFIGURATION
-------------
* No global configuration.
Any method of payment mandatory to insert the API key and
the choice of server usage (Test|Production).
Other configurations are defined by plugins chosen or made.
* See documentation of module Payment for create a new payment method.
TROUBLESHOOTING
---------------
FAQ
---
Q: What is the use of the plugin?
A: The implementation of the plugin allows you to define a plug that fits your needs.
You can then customize the management of the data sent to the server MultiSafepay
without using hooks or "to the moon and back journey" to change or implement customizations.
Also in the plugin, you can also define the management of return notification
from the server MultiSafepay.
It is hoped that by using this infrastructure makes the customization,
when required, more facilitated.
Q: How can I create my own plugin?
A: You have to create a class that extends the interface MultiSafePayPaymentCreatorOrderInterface,
implement the methods required by the class
(see example of how the base class MultiSafePayPaymentCreatorOrderBase
and MultiSafePayPaymentCreatorOrderRedirect as derived).
Make known to form your class by implementing the coupling
hook_multisafepay_payment_plugin_msp_order_info() defining the required data.
Once followed these steps the plugin will be selected
in the configuration of the payment method.
Q: I have to do a little customization, have I to create a new plugin too?
A: Not necessarily. You can use a plugin already provided and the hook
hook_multisafepay_payment_msp_order().
MAINTAINERS
-----------
Current maintainers:
* Luca Cracco (luca_cracco) - https://www.drupal.org/u/luca_cracco
* Emanuel Righetto (erighetto) - https://www.drupal.org/u/emanuelrighetto
This project has been sponsored by:
* AthenaSPA
Athena is an International group with three divisions and ten plants both
in Italy and around the world.
Athena Industries: applications and automotive supplies, earth movement
and agricultural machinery, food industry, adaptors, compressors,
heat and cold machinery.
Athena Parts: motorbike, scooter, maxi scooter, off road and automotive
mechanics and electronics.
Athena Evolution: Italian distribution of brands such as GoPro, VR|46,
Red Bull Racing Eyewear, Ogio, Skullcandy, TomTom, XSories, Jawbone,
Go4Fun and Klaxon.