Datatrans Payment Library for Android Developer's Manual Datatrans AG Swiss E-Payment Competence Kreuzbühlstrasse 26, 8008 Zürich, Switzerland el! "#$ 44 2%6 8$ &$, 'ax "#$ 44 2%6 8$ &8 www!datatrans!ch )ersion: #!6!# Datatrans Payment Library for Android Date* 202$+08-2, Developer's Manual -age* 2/20 Revisions Version Date Author Comment 0.$ 201$+02+08 1asil 2chermann First dra4t ie44ects a. $!0 201$+02+$% 1asil 2chermann $!0 $!$ 201$+$2+$% 1asil 2chermann $!$ 5-ostFinance support6 $!2 201,+0$+$% 1asil 2chermann $!2 5Maintenance release6 $!, 201,+$0-2& 1asil 2chermann My8ne added $!# 201#+02+$, 1asil 2chermann -a73ent options, 2ndroid #!# 9(es $!% 201#+04+$0 1asil 2chermann 2lias .eneration in standard mode: -a7-al, -ostFinance ;ard recurrin. payments $!%!$ 201#+07+03 1asil 2chermann ;ertificate pinnin. option $!%!2 201#+08+$, 1asil 2chermann Swisscom <as7pay added $!6.0 201#+09-$2 1asil 2chermann 2lias .eneration in hidden mode $!6.$ 201#+$$+20 1asil 2chermann -ostFinance Card re.istration $!6.2 201%+01+09 1asil 2chermann arget SDK 2$ support 52ndroid %6 $!0!0 201%+03+$6 1asil 2chermann <asypay 2lias support, =astschrift 5<=)6 method added, conte(t abstraction 5DisplayConte(t6 $!0!$ 201%+04+02 1asil 2chermann <=) aliases with bankroutin. $!0!2 201%+04+$6 1asil 2chermann =an.ua.e 9( $!8!0 201%+07+$0 1asil 2chermann Swiss1illin. added $!&!0 201%+$0-$6 1asil 2chermann ?;1 added 2!0.0 201%+$0-2& 1asil 2chermann @AB added 2!0.$ 2016-06+2& 1asil 2chermann @AB with new pa73ent pa.es 2!$!0 2016-00+$# -atrick Schmid @AB alias support 2!$!$ 2016-08+$& -atrick Schmid @AB alias adjust3ents 2!$!2 2016-09+20 -atrick Schmid Decurrin. payment 3ethods returned if authorization skipped 2!2!0 2016-$$+$6 -atrick Schmid Currency on alias reEuest, switch to backup FD=, @AB 9( 2!2!$ 2010+01+09 -atrick Schmid Discover added, payment 3ethod on 1usiness<(ception 2!2!2 2010+03+2# -atrick Schmid -a73ent with amount G 0 only 2!,!0 2010+07+07 -atrick Schmid De>a added, merchant properties always sent to post FD= 2!#!0 2010+08+2% -atrick Schmid @AB payments supported a.ain 2!%!0 2010+09-2& BathanaHl Mä.li @AB alias support added 5 @AB Fser on 'ile6 2!6.0 2018+0$+,$ BathanaHl Mä.li -artial =S $!2 support 4or 2-A $6-$& 2!0!0 2018+03+$% -atrick Schmid <nhanced -a7-al securit7 2!8!0 2018+0#+2% -atrick Schmid -ostFinance Card e(piry, Diners ;)) Fix 2!8!$ 2018+0%+03 BathanaHl Mä.li 2dded F2 - payment 3ethod Datatrans 2J, Kreuzbühlstrasse 26, ;K 8008 Zürich + el! "#1 ## 2%6 8$ &$, 'a( "#1 ## 2%6 8$ &8 + www!datatrans!ch )ersion: #!6!# Datatrans Payment Library for Android Date* 202$+08-2, Developer's Manual -age* ,/20 2!8!2 2018+0%+$8 BathanaHl Mä.li Amproved parameter decodin. 2!8!, 2018+07+$0 BathanaHl Mä.li 1u.9( credit card auto9ll 2!8!# 2018+07+$8 BathanaHl Mä.li De>a Dail L De>a =unch support 2!8!% 2018+08+$# -atrick Schmid Deplaced -aymentMethodSwiss1illin. by option 2!&!0 2018+08+,0 -atrick Schmid Sa3sun. -ay and 1yjuno direct invoice added ,!0.0 2018+09-$# -atrick Schmid 2dded Joo.le -a7 ,!$!0 2018+$2+06 -atrick Schmid De4erred authorization ,!$!$ 201&+0$+28 -atrick Schmid Sa3sun. -ay 2-A chan.es ,!$!2 201&+02+$% BathanaHl Mä.li Settlement step added to payment process ,!$!, 201&+02+22 -atrick Schmid @AB reEtype 9( ,!2!0 201&+0#+09 -atrick Schmid Detailed error codes, switched to 22D packa.in., uniform 3erchant properties, Samsun. -ay service ADs ,!,!0 201&+00+02 -atrick Fo3peyrine 2dded Swiss-ass, re4actored 2ddress L Customer objects, recurrin. payment 3ethods to/4rom JS8N strin., 1u.9(es ,!#!0 201&+00+2% Melanie Hüsser 2dded Swiss-ass alias and -8@<D-2M ,!%!0 201&+08+$, -atrick Fo3peyrine ,D secure when reEuestin. alias, verify credit card alias ,!%!$ 201&+$$+04 -atrick Fo3peyrine Demoved custo3er option reEuirement 4or alias payment ,!%!2 201&+$2+$2 -atrick Fo3peyrine Amproved activity lifecycle handlin. ,!%!, 2020-02+2% -atrick Fo3peyrine @orkaround o4 2ndroid % @eb)iew bu. #!0.0 2020-07+01 -atrick Fo3peyrine Support 4or new backend JS8N 2-A Now #!0.$ 2020-07+09 -atrick Fo3peyrine 1u.9(es #!$!0 2020-07+28 -atrick Fo3peyrine 2dded Coop Supercard #!$!$ 2020-08+2$ -atrick Fo3peyrine 2-A ,0 release, support createCon9.urationConte(t #!2!0 2020-09-2$ -atrick Fo3peyrine 2dded -a7sa4ecard, 1u.9(es #!2!$ 2020-$0-09 -atrick Fo3peyrine 2dded merchant properties on all @AB calls #!2!2 2020-$0-20 -atrick Fo3peyrine @indow leak crash 9( #!,!0 2020-$$+03 -atrick Fo3peyrine Support -ostFinance app switch #!,!$ 2020-$$+2% -atrick Fo3peyrine 2daptin. to backend 2-A chan.e #!,!2 2020-$$+20 -atrick Fo3peyrine Fse re4no 4rom backend JS8N 2-A Now 4or alias reEuests #!,!, 2020-$2+08 BathanaHl Mä.li @AB alias reEuest returns transaction Ad #!,!# 202$+0$+$, -atrick Fo3peyrine Amprove stability o4 e(ternal web process #!6.0 202$+04+$2 Melanie Hüsser 2dded 1oncard 5=unch+Check), added 1yjuno alias, additional in4ormation when ,D secure 4ails #!6.$ 202$+06-$# -atrick Fo3peyrine <(piration date in card alias reEuest, 9( De>a alias payment #!6.2 202$+08+05 Melanie Hüsser Send 1yjuno in4o parameters durin. alias payment #!6., 202$+08+$, Melanie Hüsser Deturn acEuirer authorization code 4or error cases #!6.# 202$+08+2, Melanie Hüsser 1u.9(es Datatrans 2J, Kreuzbühlstrasse 26, ;K 8008 Zürich + el! "#1 ## 2%6 8$ &$, 'a( "#1 ## 2%6 8$ &8 + www!datatrans!ch )ersion: #!6!# Datatrans Payment Library for Android Date* 202$+08-2, Developer's Manual -age* #/20 ab!e of Contents 1 "ntroduction 6 1.1 Document Structure 6 1.2 Scope 6 1.3 Conventions 6 2 #verview 8 2.1 Payment $ethods 8 2.2 Supported P!atforms 8 2.3 Library as%s 8 2.4 Payment Process 9 2.5 User "nterface 9 3 Key Concepts 10 3.1 PaymentProcessAndroid 10 3.2 Library "nvocation 10 3.3 State (oti)cation 12 3.4 Recurrin* payments 13 3.4.1 5De+6Serialization to/4rom ?SOB of recurring payment method 13 3.5 Payment method re*istration +a!ias re,uest- 14 3.5.1 -ayment method selection/input b7 librar7 5standard mode6 14 3.5.2 -ayment method preselected b7 app, input by librar7 14 3.5.3 ;redit card selection/input by app 5hidden mode6 15 3.6 Deferred Authori.ation 15 3.7 $erchant Noti)cation 16 3.8 Error Hand!in* 17 3.8.1 echnical <rrors 17 3.8.2 1usiness <rrors 17 3.8.3 SS= <rrors 17 3.9 New 0S#N AP" 1!ow 17 3.9.1 ;redit card selection/input by app 5hidden mode6 18 4 $andatory settin*s 19 4.1 2"( 19 4.1.1 @AB not installed error 19 4.2 PayPa! 19 4.3 Swiss3i!!in* 20 4.4 3y4uno 20 4.5 SwissPass 20 4.6 P#WERPA5 21 4.7 Paysafecard 21 4.8 Samsun* Pay 21 4.8.1 ;onfi.ure apps 21 4.8.2 Supported Betwor>s 5;ards6 21 Datatrans 2J, Kreuzbühlstrasse 26, ;K 8008 Zürich + el! "#1 ## 2%6 8$ &$, 'a( "#1 ## 2%6 8$ &8 + www!datatrans!ch )ersion: #!6!# Datatrans Payment Library for Android Date* 202$+08-2, Developer's Manual -age* %/20 4.8.3 De.ular -ayment 22 4.8.4 Samsung -ay 1utton 22 4.9 Goo*!e Pay 22 4.9.1 ;onfi.ure app 4or Joogle -ay 22 4.9.2 Supported Betwor>s 5;ards6 22 4.9.3 De.ular -ayment 23 4.9.4 Joogle -ay 1utton 23 4.9.5 Joing =ive 23 4.10 Recurrin* payment methods +de-)seria!i.ation to6from 0S#( 23 5 AP" 24 6 Library "nte*ration 25 6.1 Pac%a*e Contents 25 6.2 Android Studio "nte*ration 25 6.3 Pro*uard6R7 ru!es 25 7 Appendi8 27 7.1 List of "!!ustrations 27 7.2 List of Code Listin*s 27 7.3 List of ab!es 27 Datatrans 2J, Kreuzbühlstrasse 26, ;K 8008 Zürich + el! "#1 ## 2%6 8$ &$, 'a( "#1 ## 2%6 8$ &8 + www!datatrans!ch )ersion: #!6!# Datatrans Payment Library for Android Date* 202$+08-2, Developer's Manual -age* 6/20 1 Introduction Datatrans 2J, leading Swiss payment service provider, developed Datatrans i8S -ayment =ibrar7, allowing application developers to easil7 inte.rate Datatrans 2JOs payment services nativel7 on the i-hone and i-ad. 'ollowing its success, a version 4or 2ndroid-based devices has been developed. his manual provides .uidance on librar7 installation, invocation, and other issues of importance to developers wishing to inte.rate Datatrans -ayment =ibrar7 5D -=6 4or 2ndroid into their mobile applications! 1.1 Document Structure Chapter 9 – "ntroduction <(plains this documentOs structure and content. Chapter 2 – #verview Jives an overview of the Datatrans -ayment =ibrar7 4or 2ndroid. Chapter < – Key Concepts <(plains >e7 concepts of D -= 4or 2ndroid and discusses some of the most common use cases! Chapter = – AP" Jives an overview over the librar7Os classes! Chapter > – "nte*ration <(plains librar7 installation and inte.ration into <clipse/2D ! 1.2 Scope his document provides information on using D -= to create mobile commerce apps on 2ndroid devices! 2s such, it is primaril7 aimed at developers! It is assumed that the reader is already 4amiliar with Datatrans 2JOs products and services! 2lso, >nowledge of the ?ava programming language, 2ndroid SDK, as well as basic understanding of <clipse and the 2D plugin are required. Detailed description of the librar7Os 2-A is not part of this document.