module ActiveMerchant #:nodoc: module Billing #:nodoc: class PaymillGateway < Gateway self.supported_countries = %w(AD AT BE BG CH CY CZ DE DK EE ES FI FO FR GB GI GR HR HU IE IL IM IS IT LI LT LU LV MC MT NL NO PL PT RO SE SI SK TR VA) self.supported_cardtypes = [:visa, :master, :american_express, :diners_club, :discover, :union_pay, :jcb] self.homepage_url = 'https://paymill.com' self.display_name = 'PAYMILL' self.money_format = :cents self.default_currency = 'EUR' self.live_url = 'https://api.paymill.com/v2/' def initialize(options = {}) requires!(options, :public_key, :private_key) super end def purchase(money, payment_method, options={}) action_with_token(:purchase, money, payment_method, options) end def authorize(money, payment_method, options = {}) action_with_token(:authorize, money, payment_method, options) end def capture(money, authorization, options = {}) post = {} add_amount(post, money, options) post[:preauthorization] = preauth(authorization) post[:description] = options[:order_id] post[:source] = 'active_merchant' commit(:post, 'transactions', post) end def refund(money, authorization, options={}) post = {} post[:amount] = amount(money) post[:description] = options[:order_id] commit(:post, "refunds/#{transaction_id(authorization)}", post) end def void(authorization, options={}) commit(:delete, "preauthorizations/#{preauth(authorization)}") end def store(credit_card, options={}) save_card(credit_card, options) end def supports_scrubbing true end def scrub(transcript) transcript. gsub(%r((Authorization: Basic )\w+), '\1[FILTERED]'). gsub(/(account.number=)(\d*)/, '\1[FILTERED]'). gsub(/(account.verification=)(\d*)/, '\1[FILTERED]') end def verify_credentials begin ssl_get(live_url + 'transactions/nonexistent', headers) rescue ResponseError => e return false if e.response.code.to_i == 401 end true end private def add_credit_card(post, credit_card, options) post['account.holder'] = (credit_card.try(:name) || '') post['account.number'] = credit_card.number post['account.expiry.month'] = sprintf('%.2i', credit_card.month) post['account.expiry.year'] = sprintf('%.4i', credit_card.year) post['account.verification'] = credit_card.verification_value post['account.email'] = (options[:email] || nil) post['presentation.amount3D'] = (options[:money] || nil) post['presentation.currency3D'] = (options[:currency] || currency( options[:money])) end def headers { 'Authorization' => ('Basic ' + Base64.strict_encode64("#{@options[:private_key]}:X").chomp) } end def commit(method, action, parameters=nil) begin raw_response = ssl_request(method, live_url + action, post_data(parameters), headers) rescue ResponseError => e begin parsed = JSON.parse(e.response.body) rescue JSON::ParserError return Response.new(false, "Unable to parse error response: '#{e.response.body}'") end return Response.new(false, response_message(parsed), parsed, {}) end response_from(raw_response) end def response_from(raw_response) parsed = JSON.parse(raw_response) options = { :authorization => authorization_from(parsed), :test => (parsed['mode'] == 'test'), } succeeded = (parsed['data'] == []) || (parsed['data']['response_code'].to_i == 20000) Response.new(succeeded, response_message(parsed), parsed, options) end def authorization_from(parsed_response) parsed_data = parsed_response['data'] return '' unless parsed_data.kind_of?(Hash) [ parsed_data['id'], parsed_data['preauthorization'].try(:[], 'id') ].join(';') end def action_with_token(action, money, payment_method, options) options[:money] = money case payment_method when String self.send("#{action}_with_token", money, payment_method, options) else MultiResponse.run do |r| r.process { save_card(payment_method, options) } r.process { self.send("#{action}_with_token", money, r.authorization, options) } end end end def purchase_with_token(money, card_token, options) post = {} add_amount(post, money, options) post[:token] = card_token post[:description] = options[:order_id] post[:source] = 'active_merchant' commit(:post, 'transactions', post) end def authorize_with_token(money, card_token, options) post = {} add_amount(post, money, options) post[:token] = card_token post[:description] = options[:order_id] post[:source] = 'active_merchant' commit(:post, 'preauthorizations', post) end def save_card(credit_card, options) post = {} add_credit_card(post, credit_card, options) post['channel.id'] = @options[:public_key] post['jsonPFunction'] = 'jsonPFunction' post['transaction.mode'] = (test? ? 'CONNECTOR_TEST' : 'LIVE') begin raw_response = ssl_request(:get, "#{save_card_url}?#{post_data(post)}", nil, {}) rescue ResponseError => e return Response.new(false, e.response.body) end response_for_save_from(raw_response) end def response_for_save_from(raw_response) options = { :test => test? } parser = ResponseParser.new(raw_response, options) parser.generate_response end def parse_reponse(response) JSON.parse(response.sub(/jsonPFunction\(/, '').sub(/\)\z/, '')) end def save_card_url (test? ? 'https://test-token.paymill.com' : 'https://token-v2.paymill.de') end def post_data(params) return nil unless params no_blanks = params.reject { |key, value| value.blank? } no_blanks.map { |key, value| "#{key}=#{CGI.escape(value.to_s)}" }.join('&') end def add_amount(post, money, options) post[:amount] = amount(money) post[:currency] = (options[:currency] || currency(money)) end def preauth(authorization) authorization.split(';').last end def transaction_id(authorization) authorization.split(';').first end RESPONSE_CODES = { 10001 => 'Undefined response', 10002 => 'Waiting for something', 11000 => 'Retry request at a later time', 20000 => 'Operation successful', 20100 => 'Funds held by acquirer', 20101 => 'Funds held by acquirer because merchant is new', 20200 => 'Transaction reversed', 20201 => 'Reversed due to chargeback', 20202 => 'Reversed due to money-back guarantee', 20203 => 'Reversed due to complaint by buyer', 20204 => 'Payment has been refunded', 20300 => 'Reversal has been canceled', 22000 => 'Initiation of transaction successful', 30000 => 'Transaction still in progress', 30100 => 'Transaction has been accepted', 31000 => 'Transaction pending', 31100 => 'Pending due to address', 31101 => 'Pending due to uncleared eCheck', 31102 => 'Pending due to risk review', 31103 => 'Pending due regulatory review', 31104 => 'Pending due to unregistered/unconfirmed receiver', 31200 => 'Pending due to unverified account', 31201 => 'Pending due to non-captured funds', 31202 => 'Pending due to international account (accept manually)', 31203 => 'Pending due to currency conflict (accept manually)', 31204 => 'Pending due to fraud filters (accept manually)', 40000 => 'Problem with transaction data', 40001 => 'Problem with payment data', 40002 => 'Invalid checksum', 40100 => 'Problem with credit card data', 40101 => 'Problem with CVV', 40102 => 'Card expired or not yet valid', 40103 => 'Card limit exceeded', 40104 => 'Card is not valid', 40105 => 'Expiry date not valid', 40106 => 'Credit card brand required', 40200 => 'Problem with bank account data', 40201 => 'Bank account data combination mismatch', 40202 => 'User authentication failed', 40300 => 'Problem with 3-D Secure data', 40301 => 'Currency/amount mismatch', 40400 => 'Problem with input data', 40401 => 'Amount too low or zero', 40402 => 'Usage field too long', 40403 => 'Currency not allowed', 40410 => 'Problem with shopping cart data', 40420 => 'Problem with address data', 40500 => 'Permission error with acquirer API', 40510 => 'Rate limit reached for acquirer API', 42000 => 'Initiation of transaction failed', 42410 => 'Initiation of transaction expired', 50000 => 'Problem with back end', 50001 => 'Country blacklisted', 50002 => 'IP address blacklisted', 50004 => 'Live mode not allowed', 50005 => 'Insufficient permissions (API key)', 50100 => 'Technical error with credit card', 50101 => 'Error limit exceeded', 50102 => 'Card declined', 50103 => 'Manipulation or stolen card', 50104 => 'Card restricted', 50105 => 'Invalid configuration data', 50200 => 'Technical error with bank account', 50201 => 'Account blacklisted', 50300 => 'Technical error with 3-D Secure', 50400 => 'Declined because of risk issues', 50401 => 'Checksum was wrong', 50402 => 'Bank account number was invalid (formal check)', 50403 => 'Technical error with risk check', 50404 => 'Unknown error with risk check', 50405 => 'Unknown bank code', 50406 => 'Open chargeback', 50407 => 'Historical chargeback', 50408 => 'Institution / public bank account (NCA)', 50409 => 'KUNO/Fraud', 50410 => 'Personal Account Protection (PAP)', 50420 => 'Rejected due to acquirer fraud settings', 50430 => 'Rejected due to acquirer risk settings', 50440 => 'Failed due to restrictions with acquirer account', 50450 => 'Failed due to restrictions with user account', 50500 => 'General timeout', 50501 => 'Timeout on side of the acquirer', 50502 => 'Risk management transaction timeout', 50600 => 'Duplicate operation', 50700 => 'Cancelled by user', 50710 => 'Failed due to funding source', 50711 => 'Payment method not usable, use other payment method', 50712 => 'Limit of funding source was exceeded', 50713 => 'Means of payment not reusable (canceled by user)', 50714 => 'Means of payment not reusable (expired)', 50720 => 'Rejected by acquirer', 50730 => 'Transaction denied by merchant', 50800 => 'Preauthorisation failed', 50810 => 'Authorisation has been voided', 50820 => 'Authorisation period expired' } def response_message(parsed_response) return parsed_response['error'] if parsed_response['error'] return 'Transaction approved.' if (parsed_response['data'] == []) code = parsed_response['data']['response_code'].to_i RESPONSE_CODES[code] || code.to_s end class ResponseParser attr_reader :raw_response, :parsed, :succeeded, :message, :options def initialize(raw_response='', options={}) @raw_response = raw_response @options = options end def generate_response parse_response if parsed['error'] handle_response_parse_error else handle_response_correct_parsing end Response.new(succeeded, message, parsed, options) end private def parse_response @parsed = JSON.parse(raw_response.sub(/jsonPFunction\(/, '').sub(/\)\z/, '')) end def handle_response_parse_error @succeeded = false @message = parsed['error']['message'] end def handle_response_correct_parsing @message = parsed['transaction']['processing']['return']['message'] if @succeeded = is_ack? @options[:authorization] = parsed['transaction']['identification']['uniqueId'] end end def is_ack? parsed['transaction']['processing']['result'] == 'ACK' end end end end end