diff --git a/eopayment/__init__.py b/eopayment/__init__.py
index 0cae975..281e151 100644
--- a/eopayment/__init__.py
+++ b/eopayment/__init__.py
@@ -20,6 +20,8 @@ import importlib
import logging
import pytz
+import six
+
from .common import ( # noqa: F401
URL, HTML, FORM, RECEIVED, ACCEPTED, PAID, DENIED,
CANCELED, CANCELLED, ERROR, WAITING, force_text,
@@ -31,6 +33,9 @@ __all__ = ['Payment', 'URL', 'HTML', 'FORM', 'SIPS', 'SYSTEMPAY', 'SPPLUS',
'DENIED', 'CANCELED', 'CANCELLED', 'ERROR', 'WAITING',
'get_backends', 'PAYFIP_WS']
+if six.PY3:
+ __all__.append('KEYWARE')
+
SIPS = 'sips'
SIPS2 = 'sips2'
SYSTEMPAY = 'systempayv2'
@@ -41,6 +46,7 @@ OGONE = 'ogone'
PAYBOX = 'paybox'
PAYZEN = 'payzen'
PAYFIP_WS = 'payfip_ws'
+KEYWARE = 'keyware'
logger = logging.getLogger(__name__)
@@ -51,7 +57,7 @@ def get_backend(kind):
return module.Payment
__BACKENDS = [DUMMY, SIPS, SIPS2, SYSTEMPAY, SPPLUS, OGONE, PAYBOX, PAYZEN,
- TIPI, PAYFIP_WS]
+ TIPI, PAYFIP_WS, KEYWARE]
def get_backends():
diff --git a/eopayment/keyware.py b/eopayment/keyware.py
new file mode 100644
index 0000000..4748527
--- /dev/null
+++ b/eopayment/keyware.py
@@ -0,0 +1,137 @@
+# eopayment - online payment library
+# Copyright (C) 2011-2020 Entr'ouvert
+#
+# This program is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see .
+
+from gettext import gettext as _
+
+import requests
+from six.moves.urllib.parse import parse_qs, urljoin
+
+from .common import (CANCELLED, ERROR, PAID, URL, WAITING, PaymentCommon,
+ PaymentException, PaymentResponse, ResponseError)
+
+__all__ = ['Payment']
+
+
+class Payment(PaymentCommon):
+ '''Implements EMS API, see https://dev.online.emspay.eu/.'''
+ service_url = 'https://api.online.emspay.eu/v1/'
+
+ description = {
+ 'caption': 'Keyware payment backend',
+ 'parameters': [
+ {
+ 'name': 'normal_return_url',
+ 'caption': _('Normal return URL'),
+ 'required': True,
+ },
+ {
+ 'name': 'automatic_return_url',
+ 'caption': _('Asychronous return URL'),
+ 'required': True,
+ },
+ {
+ 'name': 'service_url',
+ 'caption': _('URL of the payment service'),
+ 'default': service_url,
+ 'type': str,
+ 'validation': lambda x: x.startswith('https'),
+ },
+ {
+ 'name': 'api_key',
+ 'caption': _('API key'),
+ 'required': True,
+ },
+ {
+ 'name': 'payment_methods',
+ 'caption': _('Allowed payment methods'),
+ 'type': list,
+ },
+ ],
+ }
+
+ def request(self, amount, email=None, first_name=None, last_name=None, **kwargs):
+ amount = int(self.clean_amount(amount, min_amount=0.01))
+
+ body = {
+ 'currency': 'EUR',
+ 'amount': amount,
+ 'return_url': self.normal_return_url,
+ 'webhook_url': self.automatic_return_url,
+ 'customer': {
+ 'email_address': email,
+ 'first_name': first_name,
+ 'last_name': last_name,
+ }
+ }
+ if self.payment_methods:
+ body['payment_methods'] = self.payment_methods
+
+ resp = self.call_endpoint('POST', 'orders', data=body)
+ return resp['id'], URL, resp['order_url']
+
+ def response(self, query_string, **kwargs):
+ fields = parse_qs(query_string, keep_blank_values=True)
+ order_id = fields['order_id'][0]
+ resp = self.call_endpoint('GET', 'orders/' + order_id)
+
+ status = resp['status']
+ if status == 'completed':
+ result = PAID
+ elif status == 'processing':
+ result = WAITING
+ elif status == 'cancelled':
+ result = CANCELLED
+ else:
+ result = ERROR
+
+ response = PaymentResponse(
+ result=result,
+ signed=True,
+ bank_data=resp,
+ order_id=order_id,
+ transaction_id=order_id,
+ bank_status=status,
+ test=bool('is-test' in resp.get('flags', []))
+ )
+ return response
+
+ def cancel(self, amount, bank_data, **kwargs):
+ order_id = bank_data['id']
+ resp = self.call_endpoint('DELETE', 'orders/' + order_id)
+ status = resp['status']
+ if not status == 'cancelled':
+ raise ResponseError('expected "cancelled" status, got "%s" instead' % status)
+ return resp
+
+ def call_endpoint(self, method, endpoint, data=None):
+ url = urljoin(self.service_url, endpoint)
+ try:
+ response = requests.request(method, url, auth=(self.api_key, ''), json=data)
+ except requests.exceptions.RequestException as e:
+ raise PaymentException('%s error on endpoint "%s": %s' % (method, endpoint, e))
+ try:
+ result = response.json()
+ except ValueError:
+ self.logger.debug('received invalid json %r', response.text)
+ raise PaymentException('%s on endpoint "%s" returned invalid JSON: %s' %
+ (method, endpoint, response.text))
+ self.logger.debug('received "%s" with status %s', result, response.status_code)
+ try:
+ response.raise_for_status()
+ except requests.exceptions.HTTPError as e:
+ raise PaymentException(
+ '%s error on endpoint "%s": %s "%s"' % (method, endpoint, e, result))
+ return result
diff --git a/tests/test_keyware.py b/tests/test_keyware.py
new file mode 100644
index 0000000..3d850e5
--- /dev/null
+++ b/tests/test_keyware.py
@@ -0,0 +1,225 @@
+# eopayment - online payment library
+# Copyright (C) 2011-2020 Entr'ouvert
+#
+# This program is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see .
+
+import json
+
+import pytest
+import requests
+import six
+from httmock import response, urlmatch, HTTMock, with_httmock, all_requests, remember_called
+
+import eopayment
+from eopayment.keyware import Payment
+
+pytestmark = pytest.mark.skipif(six.PY2, reason='this payment module only supports python3')
+
+WEBHOOK_URL = 'https://callback.example.com'
+RETURN_URL = 'https://return.example.com'
+API_KEY = 'test'
+
+ORDER_ID = "1c969951-f5f1-4290-ae41-6177961fb3cb"
+QUERY_STRING = 'order_id=' + ORDER_ID
+
+
+POST_ORDER_RESPONSE = {
+ "amount": 995,
+ "client": {
+ "user_agent": "Testing API"
+ },
+ "created": "2016-07-04T11:41:57.121017+00:00",
+ "currency": "EUR",
+ "description": "Example description",
+ "id": ORDER_ID,
+ "merchant_id": "7131b462-1b7d-489f-aba9-de2f0eadc9dc",
+ "modified": "2016-07-04T11:41:57.183822+00:00",
+ "order_url": "https://api.online.emspay.eu/pay/1c969951-f5f1-4290-ae41-6177961fb3cb/",
+ "project_id": "1ef558ed-d77d-470d-b43b-c0f4a131bcef",
+ "status": "new"
+}
+
+GET_ORDER_RESPONSE = {
+ "amount": 995,
+ "client": {
+ "user_agent": "Testing API"
+ },
+ "created": "2016-07-04T11:41:55.635115+00:00",
+ "currency": "EUR",
+ "description": "Example order #1",
+ "id": ORDER_ID,
+ "last_transaction_added": "2016-07-04T11:41:55.831655+00:00",
+ "merchant_id": "7131b462-1b7d-489f-aba9-de2f0eadc9dc",
+ "merchant_order_id": "EXAMPLE001",
+ "modified": "2016-07-04T11:41:56.215543+00:00",
+ "project_id": "1ef558ed-d77d-470d-b43b-c0f4a131bcef",
+ "return_url": "http://www.example.com/",
+ "status": "completed",
+ "transactions": [
+ {
+ "amount": 995,
+ "balance": "internal",
+ "created": "2016-07-04T11:41:55.831655+00:00",
+ "credit_debit": "credit",
+ "currency": "EUR",
+ "description": "Example order #1",
+ "events": [
+ {
+ "event": "new",
+ "id": "0c4bd0cd-f197-446b-b218-39cbeb028290",
+ "noticed": "2016-07-04T11:41:55.987468+00:00",
+ "occurred": "2016-07-04T11:41:55.831655+00:00",
+ "source": "set_status"
+ }
+ ],
+ "expiration_period": "PT60M",
+ "id": "6c81499c-14e4-4974-99e5-fe72ce019411",
+ "merchant_id": "7131b462-1b7d-489f-aba9-de2f0eadc9dc",
+ "modified": "2016-07-04T11:41:56.065147+00:00",
+ "order_id": ORDER_ID,
+ "payment_method": "ideal",
+ "payment_method_details": {
+ "issuer_id": "INGBNL2A",
+ },
+ "payment_url": "https://api.online.emspay.eu/redirect/6c81499c-14e4-4974-99e5-fe72ce019411/to/payment/",
+ "project_id": "1ef558ed-d77d-470d-b43b-c0f4a131bcef",
+ "status": "completed"
+ }
+ ]
+}
+
+
+@remember_called
+@urlmatch(scheme='https', netloc='api.online.emspay.eu', path='/v1/orders', method='POST')
+def add_order(url, request):
+ return response(200, POST_ORDER_RESPONSE, request=request)
+
+@remember_called
+@urlmatch(scheme='https', netloc='api.online.emspay.eu', path='/v1/orders', method='GET')
+def successful_order(url, request):
+ return response(200, GET_ORDER_RESPONSE, request=request)
+
+@remember_called
+@urlmatch(scheme='https', netloc='api.online.emspay.eu', path=r'/v1/orders', method='DELETE')
+def cancelled_order(url, request):
+ resp = GET_ORDER_RESPONSE.copy()
+ resp['status'] = 'cancelled'
+ return response(200, resp, request=request)
+
+@remember_called
+@urlmatch(scheme='https', netloc='api.online.emspay.eu', path='/v1/orders')
+def error_order(url, request):
+ resp = GET_ORDER_RESPONSE.copy()
+ resp['status'] = 'error'
+ return response(200, resp, request=request)
+
+@remember_called
+@urlmatch(scheme='https', netloc='api.online.emspay.eu', path='/v1/orders', method='GET')
+def connection_error(url, request):
+ raise requests.ConnectionError('test msg')
+
+@remember_called
+@urlmatch(scheme='https', netloc='api.online.emspay.eu', path='/v1/orders', method='GET')
+def http_error(url, request):
+ error_payload = {'error': {'status': 400, 'type': 'Bad request', 'value': 'error'}}
+ return response(400, error_payload, request=request)
+
+@remember_called
+@urlmatch(scheme='https', netloc='api.online.emspay.eu', path='/v1/orders', method='GET')
+def invalid_json(url, request):
+ return response(200, '{', request=request)
+
+@pytest.fixture
+def keyware():
+ return Payment({
+ 'normal_return_url': RETURN_URL,
+ 'automatic_return_url': WEBHOOK_URL,
+ 'api_key': API_KEY,
+ 'payment_methods': ['ideal'],
+ })
+
+
+@with_httmock(add_order)
+def test_keyware_request(keyware):
+ email = 'test@test.com'
+ order_id, kind, url = keyware.request(2.5, email=email)
+
+ assert order_id == ORDER_ID
+ assert kind == eopayment.URL
+ assert 'api.online.emspay.eu/pay/' in url
+
+ body = json.loads(add_order.call['requests'][0].body.decode())
+ assert body['currency'] == 'EUR'
+ assert body['customer']['email_address'] == email
+ assert isinstance(body['amount'], int)
+ assert body['amount'] == 250
+ assert body['webhook_url'] == WEBHOOK_URL
+ assert body['return_url'] == RETURN_URL
+
+
+@with_httmock(successful_order)
+def test_keyware_response(keyware):
+ payment_response = keyware.response(QUERY_STRING)
+
+ assert payment_response.result == eopayment.PAID
+ assert payment_response.signed is True
+ assert payment_response.bank_data == GET_ORDER_RESPONSE
+ assert payment_response.order_id == ORDER_ID
+ assert payment_response.transaction_id == ORDER_ID
+ assert payment_response.bank_status == 'completed'
+ assert payment_response.test is False
+
+ request = successful_order.call['requests'][0]
+ assert ORDER_ID in request.url
+
+
+@with_httmock(error_order)
+def test_keyware_response_error(keyware):
+ payment_response = keyware.response(QUERY_STRING)
+ assert payment_response.result == eopayment.ERROR
+
+
+@with_httmock(cancelled_order)
+def test_keyware_cancel(keyware):
+ resp = keyware.cancel(amount=995, bank_data=POST_ORDER_RESPONSE)
+ request = cancelled_order.call['requests'][0]
+ assert ORDER_ID in request.url
+
+
+@with_httmock(error_order)
+def test_keyware_cancel_error(keyware):
+ with pytest.raises(eopayment.ResponseError) as excinfo:
+ keyware.cancel(amount=995, bank_data=POST_ORDER_RESPONSE)
+ assert 'expected "cancelled" status, got "error" instead' in str(excinfo.value)
+
+
+@with_httmock(connection_error)
+def test_keyware_endpoint_connection_error(keyware):
+ with pytest.raises(eopayment.PaymentException) as excinfo:
+ keyware.call_endpoint('GET', 'orders')
+ assert 'test msg' in str(excinfo.value)
+
+
+@with_httmock(http_error)
+def test_keyware_endpoint_http_error(keyware):
+ with pytest.raises(eopayment.PaymentException) as excinfo:
+ keyware.call_endpoint('GET', 'orders')
+ assert 'Bad request' in str(excinfo.value)
+
+
+@with_httmock(invalid_json)
+def test_keyware_endpoint_json_error(keyware):
+ with pytest.raises(eopayment.PaymentException) as excinfo:
+ keyware.call_endpoint('GET', 'orders')
+ assert 'JSON' in str(excinfo.value)