gw3-python-client/examples/make_dms.py at master · TransactPRO/gw3-python-client · GitHub

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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
#!/usr/bin/env python3

# The MIT License
#
# Copyright (c) 2017 Transact Pro.
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.
import pprint
import random
import string

import gateway
from gateway.responses.constants import Status

# Step 0
# Init client class for our work flow
GATEWAY_CLIENT = gateway.Client()

# Step 1
# Add your merchant authorization data
GATEWAY_CLIENT.create_auth_data().add_account_guid(guid='3383e58e-9cde-4ffa-85cf-81cd25b2423e')
GATEWAY_CLIENT.create_auth_data().add_secret_key(value='IvjBhoeDKUkCMOif58gyxlRNb7QpdmtF')

# Step 2
# Ok, now build our transaction request
# Set operation DMS hold
transaction_dms_hold = GATEWAY_CLIENT.set_operation().dms_hold()

# Add our credit card (PAN) values, cvv, names, pan number
transaction_dms_hold.payment_method_set().add_pan_cardholder_name(first_last_name='Jane Doe')
transaction_dms_hold.payment_method_set().add_pan_cvv_code(cvv_number='442')
transaction_dms_hold.payment_method_set().add_pan_expiry_date(mm_yy='12/30')
transaction_dms_hold.payment_method_set().add_pan_number(pan_number='4222222222222')

# Now we settings, how much we must take off money from our cardholder
transaction_dms_hold.money_data_set().add_payment_amount(minor_value=5000)
transaction_dms_hold.money_data_set().add_payment_currency(iso_4217_ccy='USD')

# If need you can setup customer data information of that transaction, but it's optional
transaction_dms_hold.customer_data_set().add_email('jane_doe@nice.example.com')
# In our case billing data and shipping data will be same
# First set billing
transaction_dms_hold.customer_data_set().add_billing_country(country='Latvia')
transaction_dms_hold.customer_data_set().add_billing_state(state='Riga')
transaction_dms_hold.customer_data_set().add_billing_city(city='Riga')
transaction_dms_hold.customer_data_set().add_billing_street(street='Gustava Zemgala gatve')
transaction_dms_hold.customer_data_set().add_billing_house(house_number='76')
transaction_dms_hold.customer_data_set().add_billing_flat(flat_number='12')
transaction_dms_hold.customer_data_set().add_billing_zip(zip_code='LV-1039')

# Now set shipping data for our transaction
transaction_dms_hold.customer_data_set().add_shipping_country(country='Latvia')
transaction_dms_hold.customer_data_set().add_shipping_state(state='Riga')
transaction_dms_hold.customer_data_set().add_shipping_city(city='Riga')
transaction_dms_hold.customer_data_set().add_shipping_street(street='Gustava Zemgala gatve')
transaction_dms_hold.customer_data_set().add_shipping_house(house_number='76')
transaction_dms_hold.customer_data_set().add_shipping_flat(flat_number='12')
transaction_dms_hold.customer_data_set().add_shipping_zip(zip_code='LV-1039')

# Don't forget to fill your merchant data in your transaction, like this one
transaction_dms_hold.merchant_order_data_set().add_merchant_side_url(url='http://example.com')
transaction_dms_hold.merchant_order_data_set().add_merchant_transaction_id(
    transaction_id=''.join(random.choice(string.ascii_lowercase) for t_id in range(random.randrange(0, 50, 2)))
)
transaction_dms_hold.merchant_order_data_set().add_merchant_order_id(
    order_id=''.join(random.choice(string.ascii_lowercase) for o_id in range(random.randrange(0, 255, 2)))
)
transaction_dms_hold.merchant_order_data_set().add_merchant_order_description(
    description='Lorem Ipsum is simply dummy text of the printing and typesetting industry.'
)
transaction_dms_hold.merchant_order_data_set().add_merchant_order_meta(
    json_object={'f_name': 'Jane', 'l_name': 'Doe', 'sequence': '0', 'title': 'president', 'url': 'nice.example.com'}
)
# So, all almost done. Set our cardholder IP. That's optionally.
transaction_dms_hold.system_data_set().add_user_ip(cardholder_ip='192.168.1.70')
transaction_dms_hold.system_data_set().add_x_forwarded_for_ip(cardholder_ip='192.168.1.70')

# Step 3
# Construct our transaction request data
dms_hold_transaction = GATEWAY_CLIENT.build_request()
print('Constructed DMS HOLD request:')
pprint.pprint(dms_hold_transaction)
print('--------------------')

# Step 4
# Now make our request via Transact pro HTTP transporter
# Or you can use your own HTTP transporter
gw_response = GATEWAY_CLIENT.make_request(request_data=dms_hold_transaction)
parsed_gw_response = transaction_dms_hold.parse(gw_response)
print('DMS Hold Response: %s' % parsed_gw_response.__dict__)
print('--------------------')
if parsed_gw_response.gw.status_code != Status.DMS_HOLD_OK:
    raise RuntimeError("Critical can't continue: transaction declined!")

# Awesome we extracted our id for next step, so prepare TO CHARGE our transaction.
# Or even just save that stuff in your database for future using

# DMS charge time
# Step 0
# Init client class for our work flow
GATEWAY_CLIENT = gateway.Client()
# Step 1
# Add your merchant authorization data
GATEWAY_CLIENT.create_auth_data().add_account_guid(guid='3383e58e-9cde-4ffa-85cf-81cd25b2423e')
GATEWAY_CLIENT.create_auth_data().add_secret_key(value='IvjBhoeDKUkCMOif58gyxlRNb7QpdmtF')
# Step 2
transaction_dms_charge = GATEWAY_CLIENT.set_operation().dms_charge()
# As we do in DMS HOLD, set needed data sets.
# For DMS CHARGE need provide gate_transaction_id form last operation DMS HOLD
transaction_dms_charge.command_data_set().add_gateway_transaction_id(gate_transaction_id=parsed_gw_response.gw.gateway_transaction_id)
# And we can charge holded data part of it or full.
# As in example:
# First payment was for the shipment in the e-commerce shop and holded 50$ from your cardholder
# But cardholder received half of goods, so we charge 20$ form hold
transaction_dms_charge.money_data_set().add_payment_amount(minor_value=2000)

# Step 3
# As usual build our request for needed operation
dms_charge_transaction = GATEWAY_CLIENT.build_request()
print('Constructed DMS CHARGE request:')
pprint.pprint(dms_charge_transaction)
print('--------------------')

# Ok, let's send request via Transact Pro HTTP transporter
gw_response = GATEWAY_CLIENT.make_request(request_data=dms_charge_transaction)
parsed_gw_response = transaction_dms_charge.parse(gw_response)
print('DMS Charge Response: %s' % parsed_gw_response.__dict__)
print('--------------------')
# That's it, happy coding