systempayv2: raise it to the level of the spplus backend

- create description,
- add descriptions to certain parameters,
- add more logs,
- add vads_order_info* parameters,
- add vads_payment_cards parameter
- set GET as the default return mode,
- fix return value of Payment.request.
This commit is contained in:
Benjamin Dauvergne 2012-05-25 15:42:04 +02:00
parent 8436f14d1e
commit 91489ed11b
1 changed files with 123 additions and 50 deletions

View File

@ -7,20 +7,25 @@ import string
import urlparse
import urllib
from decimal import Decimal
from gettext import gettext as _
from common import PaymentCommon, URL, PaymentResponse
from common import PaymentCommon, PaymentResponse, URL
from cb import CB_RESPONSE_CODES
__all__ = ['Payment']
PAYMENT_URL = "https://systempay.cyberpluspaiement.com/vads-payment/"
SERVICE_URL = "https://paiement.systempay.fr/vads-payment/"
LOGGER = logging.getLogger(__name__)
SERVICE_URL = '???'
VADS_TRANS_DATE = 'vads_trans_date'
VADS_AUTH_NUMBER = 'vads_auth_number'
VADS_AUTH_RESULT = 'vads_auth_result'
VADS_RESULT = 'vads_result'
VADS_EXTRA_RESULT = 'vads_extra_result'
VADS_CUST_EMAIL = 'vads_cust_email'
VADS_URL_RETURN = 'vads_url_return'
VADS_AMOUNT = 'vads_amount'
VADS_SITE_ID = 'vads_site_id'
VADS_TRANS_ID = 'vads_trans_id'
SIGNATURE = 'signature'
VADS_TRANS_ID = 'vads_trans_id'
@ -33,7 +38,8 @@ def isonow():
class Parameter:
def __init__(self, name, ptype, code, max_length=None, length=None,
needed=False, default=None, choices=None):
needed=False, default=None, choices=None, description=None,
help_text=None):
self.name = name
self.ptype = ptype
self.code = code
@ -42,6 +48,8 @@ class Parameter:
self.needed = needed
self.default = default
self.choices = choices
self.description = description
self.help_text = help_text
def check_value(self, value):
if self.length and len(str(value)) != self.length:
@ -86,24 +94,33 @@ PARAMETERS = [
Parameter('vads_cust_title', 'an', 17, max_length=63),
Parameter('vads_cust_city', 'an', 21, max_length=63),
Parameter('vads_cust_zip', 'an', 20, max_length=63),
# must be TEST or PRODUCTION
Parameter('vads_ctx_mode', 'a', 11, needed=True),
Parameter('vads_ctx_mode', 'a', 11, needed=True, choices=('TEST',
'PRODUCTION'), default='TEST'),
# ISO 639 code
Parameter('vads_language', 'a', 12, length=2, default='fr'),
Parameter('vads_order_id', 'an-', 13, max_length=32),
Parameter('vads_order_info', 'an', 14, max_length=255),
Parameter('vads_order_info2', 'an', 14, max_length=255),
Parameter('vads_order_info3', 'an', 14, max_length=255),
Parameter('vads_order_info', 'an', 14, max_length=255,
description=_(u"Complément d'information 1")),
Parameter('vads_order_info2', 'an', 14, max_length=255,
description=_(u"Complément d'information 2")),
Parameter('vads_order_info3', 'an', 14, max_length=255,
description=_(u"Complément d'information 3")),
Parameter('vads_page_action', None, 46, needed=True, default='PAYMENT',
choices=('PAYMENT',)),
Parameter('vads_payment_cards', 'an;', 8, max_length=127, default=''),
Parameter('vads_payment_cards', 'an;', 8, max_length=127, default='',
description=_(u'Liste des cartes de paiement acceptées'),
help_text=_(u'vide ou des valeurs sépareés par un point-virgule parmi '
'AMEX, AURORE-MULTI, BUYSTER, CB, COFINOGA, E-CARTEBLEUE, '
'MASTERCARD, JCB, MAESTRO, ONEY, ONEY_SANDBOX, PAYPAL, '
'PAYPAL_SB, PAYSAFECARD, VISA')),
# must be SINGLE or MULTI with parameters
Parameter('vads_payment_config', '', 07, default='SINGLE',
choices=('SINGLE','MULTI'), needed=True),
Parameter('vads_return_mode', None, 48, default='NONE',
Parameter('vads_return_mode', None, 48, default='GET',
choices=('','NONE','POST','GET')),
Parameter('signature', 'an', None, length=40),
Parameter('vads_site_id', 'n', 02, length=8, needed=True),
Parameter('vads_site_id', 'n', 02, length=8, needed=True,
description=_(u'Identifiant de la boutique')),
Parameter('vads_theme_config', 'ans', 32, max_length=255),
Parameter(VADS_TRANS_DATE, 'n', 04, length=14, needed=True,
default=isonow),
@ -121,6 +138,7 @@ PARAMETERS = [
Parameter('vads_user_info', 'ans', 61, max_length=255),
Parameter('vads_contracts', 'ans', 62, max_length=255),
]
PARAMETER_MAP = { parameter.name: parameter for parameter in PARAMETERS }
AUTH_RESULT_MAP = CB_RESPONSE_CODES
@ -155,33 +173,94 @@ def add_vads(kwargs):
new_vargs['vads_'+k] = v
return new_vargs
def check_vads(kwargs, exclude=[]):
for parameter in PARAMETERS:
name = parameter.name
if name not in kwargs and name not in exclude and parameter.needed:
raise ValueError('parameter %s must be defined' % name)
if name in kwargs and not parameter.check_value(kwargs[name]):
raise ValueError('parameter %s value %s is not of the type %s' % (
name, kwargs[name],
parameter.ptype))
class Payment(PaymentCommon):
'''
ex.: Payment(secrets={'TEST': 'xxx', 'PRODUCTION': 'yyyy'}, site_id=123,
ctx_mode='PRODUCTION')
Produce request for and verify response from the SystemPay payment
gateway.
>>> gw =Payment(dict(secret_test='xxx', secret_production='yyyy' site_id=123,
ctx_mode='PRODUCTION')
>>> print gw.request(100)
('20120525093304_188620',
'https://paiement.systempay.fr/vads-payment/?vads_url_return=http%3A%2F%2Furl.de.retour%2Fretour.php&vads_cust_country=FR&vads_site_id=&vads_payment_config=SINGLE&vads_trans_id=188620&vads_action_mode=INTERACTIVE&vads_contrib=eopayment&vads_page_action=PAYMENT&vads_trans_date=20120525093304&vads_ctx_mode=TEST&vads_validation_mode=&vads_version=V2&vads_payment_cards=&signature=5d412498ab523627ec5730a09118f75afa602af5&vads_language=fr&vads_capture_delay=&vads_currency=978&vads_amount=100&vads_return_mode=NONE',
{'vads_url_return': 'http://url.de.retour/retour.php',
'vads_cust_country': 'FR', 'vads_site_id': '',
'vads_payment_config': 'SINGLE', 'vads_trans_id': '188620',
'vads_action_mode': 'INTERACTIVE', 'vads_contrib': 'eopayment',
'vads_page_action': 'PAYMENT', 'vads_trans_date': '20120525093304',
'vads_ctx_mode': 'TEST', 'vads_validation_mode': '',
'vads_version': 'V2', 'vads_payment_cards': '', 'signature':
'5d412498ab523627ec5730a09118f75afa602af5', 'vads_language': 'fr',
'vads_capture_delay': '', 'vads_currency': 978, 'vads_amount': 100,
'vads_return_mode': 'NONE'})
'''
description = {
'caption': 'SystemPay, système de paiment du groupe BPCE',
'parameters': [
{ 'name': 'service_url',
'default': SERVICE_URL,
'caption': _(u'URL du service de paiment'),
'help_text': _(u'ne pas modifier si vous ne savez pas'),
'validation': lambda x: x.startswith('http'),
},
{ 'name': 'secret_test',
'caption': _(u'Secret pour la configuration de TEST'),
'validation': str.isdigit,
},
{ 'name': 'secret_production',
'caption': _(u'Secret pour la configuration de PRODUCTION'),
'validation': str.isdigit,
},
]
}
for name in (VADS_SITE_ID, 'vads_order_info', 'vads_order_info2',
'vads_order_info3', 'vads_payment_cards', 'vads_payment_config'):
parameter = PARAMETER_MAP[name]
x = { 'name': name,
'caption': parameter.description or name,
'validation': parameter.check_value,
}
description['parameters'].append(x)
def __init__(self, options, logger=LOGGER):
self.secrets = options.pop('secrets')
self.service_url = options.pop('service_url', SERVICE_URL)
self.secret_test = options.pop('secret_test')
self.secret_production = options.pop('secret_production', None)
options = add_vads(options)
self.options = options
self.logger = logger
def request(self, amount, email=None, next_url=None, logger=LOGGER):
def request(self, amount, email=None, next_url=None, **kwargs):
'''
Create a dictionary to send a payment request to systempay the
Credit Card payment server of the NATIXIS group
'''
kwargs = add_vads({'amount': amount})
if Decimal(kwargs['vads_amount']) < 0:
raise TypeError('amount must be an integer >= 0')
self.logger.debug('%s amount %s email %s next_url %s, kwargs: %s',
__name__, amount, email, next_url, kwargs)
kwargs.update(add_vads({'amount': amount}))
if Decimal(kwargs[VADS_AMOUNT]) < 0:
raise ValueError('amount must be an integer >= 0')
if email:
kwargs['vads_cust_email'] = email
kwargs[VADS_CUST_EMAIL] = email
if next_url:
kwargs['vads_url_return'] = next_url
kwargs[VADS_URL_RETURN] = next_url
transaction_id = self.transaction_id(6,
string.digits, 'systempay', self.options['vads_site_id'])
kwargs['vads_trans_id'] = transaction_id
string.digits, 'systempay', self.options[VADS_SITE_ID])
kwargs[VADS_TRANS_ID] = transaction_id
fields = kwargs
for parameter in PARAMETERS:
name = parameter.name
@ -195,21 +274,16 @@ class Payment(PaymentCommon):
fields[name] = parameter.default()
else:
fields[name] = parameter.default
# raise error if needed parameters are absent
if name not in fields and parameter.needed:
raise ValueError('payment request is missing the %s parameter,\
parameters received: %s' % (name, kwargs))
if name in fields \
and not parameter.check_value(fields[name]):
raise TypeError('%s value %s is not of the type %s' % (
name, fields[name],
parameter.ptype))
check_vads(fields)
fields[SIGNATURE] = self.signature(fields)
self.logger.debug('%s request contains fields: %s', __name__, fields)
url = '%s?%s' % (SERVICE_URL, urllib.urlencode(fields))
self.logger.debug('%s return url %s', __name__, url)
transaction_id = '%s_%s' % (fields[VADS_TRANS_DATE], transaction_id)
return transaction_id, URL, fields
self.logger.debug('%s transaction id: %s', __name__, transaction_id)
return transaction_id, URL, url
def response(self, query_string, logger=LOGGER):
def response(self, query_string):
fields = urlparse.parse_qs(query_string)
copy = fields.copy()
bank_status = []
@ -237,16 +311,16 @@ parameters received: %s' % (name, kwargs))
copy[VADS_EXTRA_RESULT] = '%s: %s' % (v,
EXTRA_RESULT_MAP.get(v, 'Code inconnu'))
bank_status.append(copy[VADS_EXTRA_RESULT])
logger.debug('checking systempay response on:')
self.logger.debug('checking systempay response on:')
for key in sorted(fields.keys):
logger.debug(' %s: %s' % (key, copy[key]))
signature = self.signature(fields, logger)
self.logger.debug(' %s: %s' % (key, copy[key]))
signature = self.signature(fields)
signature_result = signature == fields[SIGNATURE]
if not signature_result:
bank_status.append('invalid signature')
result = fields[VADS_AUTH_RESULT] == '00'
signed_result = signature_result and result
logger.debug('signature check result: %s' % result)
self.logger.debug('signature check result: %s' % result)
transaction_id = '%s_%s' % (copy[VADS_TRANS_DATE], copy[VADS_TRANS_ID])
# the VADS_AUTH_NUMBER is the number to match payment in bank logs
copy[self.BANK_ID] = copy.get(VADS_AUTH_NUMBER, '')
@ -259,22 +333,21 @@ parameters received: %s' % (name, kwargs))
bank_status=' - '.join(bank_status))
return response
def signature(self, fields, logger):
logger.debug('got fields %s to sign' % fields )
def signature(self, fields):
self.logger.debug('got fields %s to sign' % fields )
ordered_keys = sorted([ key for key in fields.keys() if key.startswith('vads_') ])
logger.debug('ordered keys %s' % ordered_keys)
self.logger.debug('ordered keys %s' % ordered_keys)
ordered_fields = [ str(fields[key]) for key in ordered_keys ]
secret = self.secrets[fields['vads_ctx_mode']]
secret = getattr(self, 'secret_%s' % fields['vads_ctx_mode'].lower())
signed_data = '+'.join(ordered_fields)
logger.debug('generating signature on «%s»' % signed_data)
self.logger.debug('generating signature on «%s»' % signed_data)
sign = hashlib.sha1('%s+%s' % (signed_data, secret)).hexdigest()
logger.debug('signature «%s»' % sign)
self.logger.debug('signature «%s»' % sign)
return sign
if __name__ == '__main__':
p = Payment(secrets={'TEST': '1234567890123456', 'PRODUCTION': 'yyy'}, site_id='00001234', ctx_mode='PRODUCTION')
print p.request(amount=100, ctx_mode='TEST', site_id='12345678',
trans_date='20090324122302', trans_id='122302',
url_return='http://url.de.retour/retour.php')
p = Payment(dict(
secret_test='',
site_id='',
ctx_mode='TEST'))
print p.request(100, vads_url_return='http://url.de.retour/retour.php')