net payment guide

8/21/2019 net payment guide

1/58

WorldNet TPS

Merchant Integration Guide


2/58

Pa e 2

Table of Contents

1 Introduction .................................................................................................. 4

2 Choosing you integration method .................................................................. 5

3 Notes beore continuing ................................................................................ !

3.1 "#S" $arameters ..................................................................................... !

3.2 Card Ty$es ............................................................................................... !

4 Payment Page and Pre%#uth Page Integration .............................................. &

4.1 "osted Payment Page .............................................................................. &

4.2 "osted Pre%#uth Page ............................................................................ 11

4.3 'ac(ground )alidation ........................................................................... 11

5 *+, Payments Integration .......................................................................... 13

5.1 -euest Ty$es ........................................................................................ 13

5.1.1 *+, Payments .................................................................................. 13

5.1.2 Pre%#uthorisation -euest ............................................................... 1&

5.1.3 Pre%#uth Com$letion -euest .......................................................... 1/

5.1.4 -eunds ............................................................................................ 10

5.1.5 *+, -euests ith eCC .................................................................. 21

5.1.5.1 eCC change -ate reuest ...................................................... 21

5.1.5.2 eCC inormation in the *+, reuests ....................................... 23

5.1.! )oiceI )oicePay .......................................................................... 25

5.2 3 Secure or *+, transactions 6WorldNet TPS +PI7 ............................ 2&

! Secure Card Storage .................................................................................... 20

!.1 Secure Card -egistration and 8$dating rom the "osted Page .............. 20

!.2 *+, Secure Card Integration ................................................................. 31

!.2.1 Secure Card etails -egistration and 8$dating ................................ 31

!.2.2 Card etails -emo9al....................................................................... 33

!.2.3 Card etails Search .......................................................................... 35

!.2.4 *+, Payments using -egistered Card .............................................. 3!

& Subscri$tions ............................................................................................... 3&

&.1 Subscri$tion -egistration rom the "osted Page .................................... 3&

&.2 *+, Subscri$tions Integration ............................................................... 4:

2010 WorldNet TPS. All rights reserved. This material is not to be reproduced, disclosed, or used ecept in accordance !ith program license or other !rittenauthorisation o" WorldNet TPS. All other trademar#s, service mar#s, and trade names re"erenced in this material are the propert$ o" their respective o!ners.


3/58

Pa e 3

&.2.1 Stored Subscri$tion Creation -euest .............................................. 4:

&.2.2 Stored Subscri$tion eletion -euest .............................................. 43

&.2.3 Subscri$tion Creation -euest ......................................................... 44

&.2.4 Subscri$tion 8$dating -euest ........................................................ 4/

&.2.5 Subscri$tion eletion -euest ......................................................... 40

&.2.! Subscri$tion Payment -euest ......................................................... 51

/ 'ul( Payments ............................................................................................. 53

/.1 -euest ;ile Submission ........................................................................ 53

/.2 -euest CS) ;ile ;ormat ........................................................................ 54

/.3 -euest ;ile Submission -es$onse ........................................................ 54

/.4 -es$onse ;ile -euest ........................................................................... 55

/.5-es$onse ;ile ;ormat ............................................................................. 5!

#$$endi #< C)) #)S -es$onses ................................................................ 5&

C)) results< ................................................................................................ 5&

#)S results< ................................................................................................ 5&

=lossary ......................................................................................................... 5/



4/58

Pa e 4

1 Introduction

The WorldNet TPS system is a secure server-based transaction rocessing service

that !ill enable your business to authorise and rocess credit"debit card transactions

online in real-time# The in$ormation needed to rocess the transactions is sent over a

secure% encryted internet connection#

&nce the customer has comleted the ayment or re-auth $orm% the WorldNet TPS

server connects !ith your ac'uiring ban( $or ayment authorisation and i$ the sale is

authorised% returns a receit to the customer# WorldNet TPS settles the transactions

automatically and the ac'uiring ban( deosits the $unds into your ban( account#

WorldNet TPS automatically archives sales that are $inali)ed so that you can re$er to

them at a later date% i$ necessary#

This guide rovides instructions on ho! to integrate a !ebsite or alication into

the system and hence ta(e automatic credit card ayments% it doesn*t cover details

related to the Sel$care System +I% lease re$er to the Sel$care +ser Guide $or the

details related to the dashboard% ayment age layout% terminal setu% noti$ication

alerts% oen and closed batch% ,irtual Terminal% MIS reorting% etc# The Sel$are

System +ser Guide can be obtained by sending a re'uest to

su$$ort>orldnett$s.com#

mailto:[email protected]:[email protected]


5/58

Pa e .

2 Choosing you integration method

There are three integration methods available% /osted Payment Page% P&ST

integration and 0M1 integration# ou can use one or a combination o$ them as re'uired%

but you should consider the integration method care$ully be$ore starting any

develoment lanning# Please see our =uide to choosing an Integration +ethod

be$ore continuing#

http://www.worldnettps.com/sites/default/files/pdfs/Guide%20to%20Integration%20Methods.pdfhttp://www.worldnettps.com/sites/default/files/pdfs/Guide%20to%20Integration%20Methods.pdf


6/58

Pa e

3 Notes beore continuing

3.1 HASH parameters

very re'uest to and resonse $rom WorldNet TPS includes an M5. /6S/

arameter# This is a security $eature to ensure that none o$ the sensitive data in the

re'uest has been modi$ied# This is achieved by including all the sensitive $ields in a

string 7these vary er re'uest tye8 along !ith the shared secret 7con$igured er

terminal8# This string is then used as the basis o$ an M5. hash#

In this document% !hen an M5. inut string is listed such as9

T-+IN#,I?@--I?#+@8NT?#TTI+?secret

you should not unclude the :;< symbols in the calculation# =or the e>amle in the

$irst section belo! i$ the shared secret !as :>4n3.c32?T< then the M5. hash !ould be

calculated as9

md56A!401::232/11:.::15%3%2::!

The otions are9 ,IS6% ,IS6 5EIT% 1T?&N% M6ST?6?5% 5EIT M6ST?6?5%

M6ST?&% +F M6ST?&% S&1&% 16S?% 6M0% 5IN?S% E% 5IS&,?% +F6S/ N

These can be con$igured in the Terminal Setu section o$ the Sel$are System and

should 61W6S be maintained to be e>actly !hat your ac'uirer has set your merchantaccount u !ith# 6ll live accounts !ill be set u !ith the correct card tyes enabled#

=or testing !e recommend using the test card numbers in our Testing =uide

document#

http://www.worldnettps.com/sites/default/files/pdfs/Testing%20Guide.pdfhttp://www.worldnettps.com/sites/default/files/pdfs/Testing%20Guide.pdf


7/58

Pa e @

4 Payment Page and Pre%#uth Page Integration

4.1 Hosted Payment Page

The /osted Payment age 7$ig# B8 is built to allo! merchants to easily integrate !ith

the WorldNet TPS system $or rocessing one o$$ ayments#

The ayment Page header and $ooter can be con$igured $rom the merchant Sel$care

system% lease chec( Sel$care +ser Guide $or details# There are demonstrations o$

/osted Payment Page customisations on our !ebsite# It is also ossible to rocess

transactions using an i=rame rather than a $ull redirect# Please contact WorldNet TPS

Suort $or $urther details#

+sing this system% the cardholders are redirected to the WorldNet TPS ayment

age once they have made the decision to buy# 6ll ayment details are collected by

WorldNet TPS to be sent to the ban( server once the submit button is ressed# The

ayment is then rocessed by WorldNet TPS and the cardholder is redirected to the

merchants receit age# WorldNet TPS also handle 35 Secure and e5 o$$erings i$

they are aroriate#

The above is accomlished by means o$ a simle /TM1 $orm ost !ith a number o$

de$ined $orm $ields 7belo!8# The $ollo!ing is the WorldNet TPS test ayment age +?19

htt$s


8/58

Pa e D

Figure 1: Hosted Payment Page

The $ollo!ing table describes the $orm $ields to be osted9

=ield Name ?e'uired 5escrition

T?MIN61I5 6 TerminalI5 rovided by WorldNet TPS#

&?5?I5 6 uni'ue identi$ier $or the order created by

the merchant# 7Ma> B2 haracters8+??N 6 3 character currency code o$ the

transaction#

6M&+NT The amount o$ the transaction as a 2 digitdecimal or an Integer value $or Pamounts#

56TTIM =ormat9 55-MM-9//9MM9SS9SSS

/6S/ 6n M5. hash# See Note B belo!#

6+T&?65 N or N# 6utomatically set the transaction to?eady in the batch# I$ not resent the

terminal de$ault !ill be used#5S?IPTI&N N 6 descrition o$ the transaction#

M6I1 N 6n email address to send a con$irmation



9/58

Pa e A

email to# Normally this is cardholder emailaddress#

?IPTP6G+?1 N This is the +?1 o$ the age on your sitethat !ill dislay the result o$ thetransaction# I$ sent this !ill override theterminal setting in the Sel$are System#

VALIDATIONURL N This will overwrite the default BackgroundValidation URL and will displa an error ifthis feature is not ena!led and sent"

ADDR#$$% N &ill pre'populate the ADDR#$$% field onthe (osted )a*ent )age if there is also avalid )O$T+OD# sent and AV$ is ena!ledfor the ter*inal" (andling of displa is*anaged ! the &orldNet and can !e todispla read onl, displa edita!le or tohide the* on for*"

ADDR#$$- N The sa*e handling as ADDR#$$%")O$T+OD# N If sent then AV$ data will !e populated"+OUNTR. N I$O /%00'%'alpha'- code" List here")(ON# N +usto*er phone nu*!er, to !e stored

against transaction" International for*atand nu*eric"

+ST&M=I15B N The merchant can con$igure any number o$custom $ields !hich !ill be added to thetransaction and returned to the receitage# 7See Note 2 belo!8

+ST&M=I15N NNotes9

B# The M5. hash is generated using the $ollo!ing as an inut string9

T?MIN61I5;&?5?I5;6M&+NT;56TTIM;?IPTP6G+?1; VALIDATIONUR

L;secret

I$ the ?IPTP6G+?1 or VALIDATIONURLarameters are not being sent% they

should not be included in the hash# n#b# In very seci$ic occasions you may also

need to include the +??N in the hash% but only i$ seci$ically instructed to do

so by WorldNet# I$ so it should be included a$ter &?5?I5 and be$ore 6M&+NT#

2# 6ny non-standard $ield !ill be considered as ustom =ield% the name does not

have to starts !ith H+ST&M=I15*# ustom =ields are those that are set u in

Terminal Setu# They !ill be included in osts to the Eac(ground ,alidation +?1

and may be romted $or on the ayment age i$ not sent#

3# 6ny other $ields that are sent to the /PP are considered to be e>tra $ields# These

!ill be returned in the resonse to the ?eciet Page% but !ill not be stored or sent

http://www.iso.org/iso/english_country_names_and_code_elementshttp://www.iso.org/iso/english_country_names_and_code_elements


10/58

Pa e BC

to the Eac(ground ,alidation +?1#

The $ollo!ing /TM1 sho!s the minimum re'uired to initiate a transaction#

JhtmlKJbodyK

J$orm actionLhtts9""testayments#!orldnetts#com"merchant"aymentage methodLostK

Jinut tyeLhidden nameLT?MIN61I5 valueL4ABCC2 "KJinut tyeLhidden nameL&?5?I5 valueL32DB "KJinut tyeLhidden nameL+??N valueL+? "KJinut tyeLhidden nameL6M&+NT valueLBC#CC "KJinut tyeLhidden nameL56TTIM valueLB.-3-2CC9BC9439CB9@3 "KJinut tyeLhidden nameL/6S/ valueLdd@@$de@[email protected] "KJinut tyeLsubmit valueLPay No! "K

J"$ormKJ"bodyK

J"htmlK

The +?1 !here WorldNet TPS !ill send transaction rocessing results is set on the

Terminal Setu screen 7?eceit Page +?1 $ield8# The $ollo!ing $ields are returned in the

resonse9

=ield Name 5escrition

T?MIN61I5 The Terminal I5 that the transaction !aser$ormed under

&?5?I5 The original order I5 o$ the transaction

6M&+NT The value o$ the transaction

?SP&NST0T The te>t o$ the authori)ation

?SP&NS&5 6 or 5 or ?76roved or 5eclined or?e$erral8

6PP?&,61&5 Si> digit 6uthode

56TTIM The time o$ the transaction created by theban(# =ormat9 -MM-55T//9MM9SS

AV$R#$)ON$# The result of the AV$ check 1if AV$ ena!led2+VVR#$)ON$# The result of the +VV check 1if +VV ena!led2UNI3U#R#4 5enerated reference that should !e stored

for tracking#6AIL If sent we will return this value)(ON# If sent we will return this value

/6S/ 6n M5. hash# See NoteB belo!#

+ST&M=I15B-N 6ny other $ields sent in the re'uest#

Notes9


T?MIN61I5;&?5?I5;6M&+NT;56TTIM;?SP&NS&5 ;?SP&NST0T

;secret

Many code e>amles on ho! to generate an M5. hash can be $ound in the Internet#

=or assistance% lease contact WorldNet TPS#



11/58

Pa e BB

4.2 Hosted Pre-Auth Page

/osted Pre-6uth age enables re-authorisation re'uests $or merchant needs such

re'uests are suorted by re-auth terminals only# 6roved re-auth transactions

must be comleted using Sel$care system be$ore they !ill be settled# =inal transaction

amount can be adusted on comletion#

/osted Pre-6uth Page loo(s $or buyer e>actly as "osted Payment Page% it has the

same set o$ $ields as Payment Page has% ust di$$erent +?1 should be used9

htt$sect to receive :&F< in the /TTP resonse

body 72 characters only8# 6ny other resonse or connection issue !ill be considered as

not-validated and a subse'uent attemt to reach the validation +?1 !ill be made later%

this rocess !ill reeat until our ma>imum allo!ed time $or validation has assed# I$

the ma>imum allo!ed time has ass and transaction !as not success$ully validated%

the transaction !ill be mar(ed as e>ired# Eac(ground ,alidation can be enabled

through the Sel$are System in the Terminal Setu section#

https://testpayments.worldnettps.com/merchant/preauthpagehttps://testpayments.worldnettps.com/merchant/preauthpage


12/58

Pa e B2

The $ollo!ing arameters are sent in the validation re'uest9


T?MIN61I5 Terminal Id

&?5?I5 &rder I5 sulied by merchant in re'uest#?SP&NS&5 6% 5 or ? 76roved%5eclined or ?e$erral8

?SP&NST0T Te>t describing transaction state# This !ill beoulated !ith an error message i$ there !asan issue during rocessing#

6PP?&,61&5 N Transaction aroval code i$ transaction !asauthorised other!ise emty

M6I1 N ardholder e-mail

56TTIM =ormat9 -MM-55T//9MM9SS

6,S?SP&NS N 6,S resonse% available only !hen 6,S is

enabled $or the terminal,,?SP&NS N ,, resonse% available only !hen ,, is

enabled $or the terminal


ustomParameters

N on$igured Terminal ustom Parameters

Notes9


T?MIN61I5;&?5?I5;6M&+NT;56TTIM;?SP&NS&5;?SP&NST0T

;secret



13/58

Pa e B3

5 *+, Payments Integration

It is also ossible to send 0M1 directly to the WorldNet TPS ayment server# This is

use$ul in a scenario !here your alication needs $ull control o$ the ayment rocess or

!here you !ish to collect card details on your site#

The 0M1 0S5 descrition $or all o$ the ac(et tyes belo! is available there9

htt$s


14/58

Pa e B4

Payment re'uest $ields descrition9


&?5?I5 6 uni'ue identi$ier $or the order created bythe merchant# 7Ma> B2 haracters8

T?MIN61I5 6 TerminalI5 rovided by WorldNet TPS# NE Please contact WorldNet TPS to be issued!ith a test terminal I5#

6M&+NT The amount o$ the transaction as a 2 digitdecimal or an Integer value $or Pamounts#

56TTIM =ormat9 55-MM-9//9MM9SS9SSSTRA+7DATA N Track - data should !e present for a swiped

card holder present transaction"

6?5N+ME? N The ayment card number, re8uired ifTRA+7DATA is not !eing sent"

6?5TP See section 3#2 above#6?50PI? N 4 digit e>iry $ield 7MM8, re8uired if

TRA+7DATA is not !eing sent"

6?5/&15?N6M The name o$ the card holder


+??N 6 3 character currency code o$ thetransaction#

=&?IGN+??NIN=&?M6TI&N

N Tag contains 5ynamic urrency onversionin$ormation# It has to be resent in thee5 enabled transactions# See *+,

Payments ith eCCT?MIN61TP The tye o$ the terminal9

B L M&T& 7Mail &rder"Telehone &rder82 L Internet

T?6NS6TI&NTP The transaction tye9C L not alicableB L Single transaction2 L ?ecurring transaction3 L Installment ayment4 L +n(no!n classi$ication

. L =ully authenticated transaction 35Secure transaction L The merchant attemted toauthenticate the cardholder% but thecardholder cannot or does not articiate in35-Secure#@ L Transaction !hen ayment data !astransmitted using SS1 encrytion% orhannel ncrytedD L Transaction in the clear% or Non Secure

6+T&?65 N or N# 6utomatically set the transaction to?eady in the batch# I$ not resent theterminal de$ault !ill be used#



15/58

Pa e B.

M6I1 N ardholder e-mail address

,, N The security code entered by the cardholder

ISS+N& N The issue no# o$ the card 7Solo8

655?SSB N The $irst address $ield $or 6,S

655?SS2 N The second address $ield $or 6,S

P&ST&5 N The ostcode $or 6,S

6,S&N1 N or N I$ this is set to no transaction !illbe rocessed and an address veri$icationchec( !ill be er$ormed against carddetails#

5S?IPTI&N N 6 descrition o$ the transaction#6OBIL#NU6B#R N Used for $6$ receipts" International for*at,

nu*eric onl")(ON# N +ard (older )hone Nu*!er stored against

transaction" International for*at, nu*eric

onl"+OUNTR. N I$O /%00'%'alpha'- code" List here"

0I5 N The 0I5 $or a 35 Secure transaction

6,, N The 6,, $or a 35 Secure transaction

MPI?= N 35-Secure Worldnet Transaction ?e$erencesulied in WorldNet TPS MPI transactions#

5,II5 N The uni'ue identi$ier string $or a connectingdevice# Mandatory $or non-server baseddevices such as handheld devices"cashregisters etc#

The $ollo!ing $ields are returned in the resonse9


?SP&NS&5 6 or 5 or ? 76roved or 5eclined or ?e$erral8


6PP?&,61&5 Si> digit 6uthode

6+T/&?IQ56M&+NT &nly sent $or seci$ic ac'uirers# Partial amountauthorised $or some transactions

56TTIM The time o$ the transaction created by the ban(#=ormat9 -MM-55T//9MM9SS

6,S?SP&NS The result o$ the 6,S chec(

,,?SP&NS The result o$ the ,, chec(

/6S/ 6n M5. hash# See Note2 belo!#

Notes9


T?MIN61I5;&?5?I5;6M&+NT;56TTIM;secret

2# The M5. hash is generated using the $ollo!ing as an inut string9


http://www.iso.org/iso/english_country_names_and_code_elementshttp://www.iso.org/iso/english_country_names_and_code_elements


16/58

Pa e B

;secret

3# The 56TTIM is the time returned by the ban( $or the transaction#

Many code e>amles on ho! to generate an M5. hash can be $ound in the Internet#

=or assistance% lease contact WorldNet TPS#

rror handling

I$ there is an error rocessing the transaction% the error string is returned in an

0M1 message !ith the simle9

J??&?KJ??&?ST?INGKJ"??&?ST?INGKJ"??&?K

tags#



17/58

Pa e B@

5.1.2 Pre%#uthorisation -euest

Pre-authorisation transactions are suorted by the ac'uirer lavon only# 35

Secure re-auth transactions are not suorted due to scheme restrictions#

>amle o$ a 0M1 Pre-6uth re'uest9

JO>ml versionLB#C encodingL+T=DOKJP?6+T/K

J&?5?I5KBCCC2D3@43BAJ"&?5?I5KJT?MIN61I5K4ABCC2J"T?MIN61I5KJ6M&+NTKB.#2J"6M&+NTKJ56TTIMKBD-B2-2CCD9CA9249B9BC.J"56TTIMKJ6?5N+ME?K4BBBBBBBBBBBBBBBJ"6?5N+ME?KJ6?5TPK,IS6J"6?5TPKJ6?50PI?KBBCAJ"6?50PI?KJ6?5/&15?N6MKoe EloggsJ"6?5/&15?N6MKJ/6S/KAc.DeDd@[email protected]"/6S/K

J+??NK+?J"+??NKJT?MIN61TPKBJ"T?MIN61TPKJT?6NS6TI&NTPK@J"T?6NS6TI&NTPKJ,,K2B4J",,K

J"P?6+T/K

Pre-6uth re'uest can have the same $ields as 0M1 P#D+NT ece$t or

#8T@-#DE *IE C#)) and +PI-; ields. Please note that Pre-6uths do not

suort 35 secure tr +ARD+URR#N+.RAT#R#$)ON$# ansactions#

=or testing% this 0M1 is osted to9

htt$sml versionLB#C encodingL+T=-DOKJP?6+T/?SP&NSK

J?SP&NS&5K6J"?SP&NS&5KJ?SP&NST0TK6PP?&,61J"?SP&NST0TK

J6PP?&,61&[email protected]"6PP?&,61&5KJ56TTIMK2CCD-B2-BDTCA9249B@J"56TTIMK

J,,?SP&NSKMJ",,?SP&NSK

J/6S/Ka$e4cDb.@$3eaCd$ee@cD$@.$ae@eACdJ"/6S/KJ"P?6+T/?SP&NSK

P?6+T/?SP&NS and P6MNT?SP&NS have mostly the same $ields set

e>cet 35 Secure $ields 76,,% 0I5% MPI?=8% 6,S&N1 and 6+T&?65# Please re$er

to the P6MNT?SP&NS section $or details#

rrors handling






18/58

Pa e BD

tags#

5.1.3 Pre%#uth Com$letion -euest

>amle o$ a Pre-6uth comletion re'uest9

JO>ml versionLB#C encodingL+T=-DOKJP?6+T/&MP1TI&NK

J&?5?I5KBCCC2D3@4B23J"&?5?I5KJT?MIN61I5K4ABCC2J"T?MIN61I5KJ6M&+NTKB2#3BJ"6M&[email protected]@J"56TTIMKJ,,[email protected]",,KJ/6S/K$$2eD4D.d@debb$C@d3d$e$$ad.DADcJ"/6S/K

J"P?6+T/&MP1TI&NK


htt$sml versionLB#C encodingL+T=-DOK

JP?6+T/&MP1TI&N?SP&NSKJ?SP&NS&5K6J"?SP&NS&5K

J?SP&NST0TK6PP?&,61J"?SP&NST0TKJ6PP?&,61&5K.B..DJ"6PP?&,61&5K

[email protected]"56TTIMKJ/6S/[email protected]$e.222J"/6S/K

J"P?6+T/&MP1TI&N?SP&NSK

Pre-6uth omletion re'uest $ields descrition9




6M&+NT The amount o$ the transaction as a 2 digitdecimal or an integer value $or Pamounts#


N Tag contains 5ynamic urrency onversionin$ormation# It is re'uired !hen comletingout o$ theB.R margin e5 transaction#See *+, Payments ith eCC

5S?IPTI&N N 6n otional descrition% overrides originalre-auth descrition i$ available#

56TTIM =ormat 55-MM-9//9MM9SS9SSS

,, N The security code entered by the cardholder# It should be available !hen ,, isenabled $or a terminal and comleting out

o$ the B.R margin transaction#/6S/ 6n M5. hash 7See Note B belo!8



19/58

Pa e BA



?SP&NS&5 6 or 5 or ?76roved or 5eclined or ?e$erral8

?SP&NST0T The te>t o$ the authori)ation6PP?&,61&5 Si> digit 6uthode

56TTIM The time o$ the transaction created by theban(# =ormat9 -MM-55T//9MM9SS

6,S?SP&NS The result o$ the 6,S chec(

,,?SP&NS The result o$ the ,, chec(

/6S/ 6n M5. hash# See Note2 belo!#

Notes9

B8 The M5. hash is generated using the $ollo!ing as an inut string9T?MIN61I5;&?5?I5;6M&+NT;56TTIM;secret

28 The M5. hash is generated using the $ollo!ing as an inut string9


;secret

rrors handling




tags#

5.1.4 -eunds

The $ollo!ing is a simle e>amle o$ a re$und via an 0M1 P&ST9

JO>ml versionLB#C encodingL+T=-DOK

J?=+N5KJ&[email protected]@.J"&?5?I5K

JT?MIN61I5K4ABCC2J"T?MIN61I5KJ6M&+NTKBCJ"6M&+NTK

J56TTIMK2C-C-2CC9B292D9C29B@BJ"56TTIMKJ/6S/Kc$aCA4$.3a.CDd2C3Bc@DA.$A$@cbbJ"/6S/K

J&P?6T&?KTest &eratorJ"&P?6T&?KJ?6S&NK=aulty GoodsJ"?6S&NK

J"?=+N5K




20/58

Pa e 2C

htt$sml versionLB#C encodingL+T=-DOKJ?=+N5?SP&NSK

J?SP&NS&5K6J"?SP&NS&5K

J?SP&NST0TKS+SSJ"?SP&NST0TKJ&[email protected]@.J"&?5?I5KJT?MIN61I5KBCCBJ"T?MIN61I5KJ6M&+NTKBCJ"6M&[email protected]"56TTIMKJ/6S/KaCaa$B4$e.3A$4dedd3C.4.DBBabJ"/6S/K

J"?=+N5?SP&NSK

The WorldNet TPS ayment system then handles subse'uent transaction settlement

and storage#

The $ollo!ing is a descrition o$ each $ield9


&?5?I5 The original order I5 o$ thetransaction#

T?MIN61I5 6 TerminalI5 rovided by WorldNetTPS# NE Please contact WorldNet TPSto be issued !ith a test terminal I5#

6M&+NT The amount o$ the transaction as a 2digits decimal or an Integer value $orP amounts#

56TTIM =ormat9 55-MM-9//9MM9SS9SSS/6S/ 6n M5. hash# See note B belo!#

&P?6T&? 6n identi$ier $or !ho e>ecuted thistransaction

?6S&N The reason $or the re$und



?SP&NS&5 6 or 5 76roved or 5eclined8


&?5?I5 6 uni'ue identi$ier $or the order created bythe merchant#

T?MIN61I5 6 Terminal I5 rovided by WorldNet TPS# NE Please contact WorldNet TPS to be issued!ith a test terminal I5#

6M&+NT The amount o$ the transaction as a 2 digitdecimal or an integer value $or P amounts#


/6S/ 6n M5. hash# See note 2 belo!#

Notes9



21/58

Pa e 2B

B8 The M5. hash is generated using the $ollo!ing as an inut string9

T?MIN61I5;&?5?I5;6M&+NT;56TTIM;secret



;secret

5.1.5 *+, -euests ith eCC

5irect 0M1 transactions 7Payment% Pre-6uth and Pre-6uth omletion8 can be 5

75ynamic urrency onversion8 enabled# This is use$ul !hen card and terminal

currencies are di$$erent# WorldNet TPS suort urrency onversion ?ate re'uest%

merchant alication can re'uest onversion ?ate $or the card% then cardholder have

to decide i$ he"she !ould li(e to use e5 service% and a$ter this aroriate re'uest to

the TPS !ill be sent# e5 enabled 0M1 transaction re'uest should include additional

tag - H=&?IGN+??NIN=&?M6TI&N* !ith all re'uired nested tags#

5 transactions are allo!ed $or the e5-enabled terminals only# 5 suort $or

the terminal can be enabled or disabled by the WorldNet TPS suort team only#

5.1.5.1 eCC change -ate reuest

The $ollo!ing is an e>amle o$ a onversion ?ate re'uest $or the Terminal I5 and

EIN9

JO>ml versionLB#C encodingL+T=-DOKJGT6?5+??N?6TK

JT?MIN61I5KBCCBJ"T?MIN61I5KJ6?5EINK4BBBBBJ"6?5EINK

J56TTIMK2@[email protected]"56TTIMKJ/6S/KB.$cC$Cb.B$a$$Acbb@@22CabDdd$ceJ"/6S/K

J"GT6?5+??N?6TK

=ields descrition9


T?MIN61I5 6 TerminalI5 rovided by WorldNetTPS# NE Please contact WorldNetTPS to be issued !ith a test terminal

I5#6?5EIN EIN# The $irst digits $rom the ard

Number



22/58

Pa e 22

56TTIM ?e'uest 5ate and Time# =ormat955-MM-9//9MM9SS9SSS


Notes9


T?MIN61I5;6?5EIN;56TTIM;secret

6 resonse $or this re'uest !ould be9

J6?5+??N?6T?SP&NSKJT?MIN61+??NK+?J"T?MIN61+??NK

J6?5+??NKGEPJ"6?5+??NKJ&N,?SI&N?6TKC#@B.@J"&N,?SI&N?6TK

J56TTIMK2@[email protected]"56TTIMK9#:+(AN5#RAT#$OUR+#NA6#;I*aginar Bank9>9amle9 HC#B23CCC*# The secret

should be set by merchant in the sel$care section#

rrors handling

I$ there is an error rocessing the re'uest% the error string is returned in an 0M1

message !ith the simle9J??&?KJ??&?ST?INGKJ"??&?ST?INGKJ"??&?K



23/58

Pa e 23

tags#

The $ollo!ing $ields are returned in the resonse i$ error has occurred9


??&?&5 Integer-value error code

??&?ST?ING Erie$ te>tual descrition

There is list o$ error codes and their brie$ descritions9

rror ode 5escrition

BCB Terminal not $ound

BC2 EIN not $ound

BC3 urrencies are the same

BC4 e5 is not allo!ed $or the terminal

BC. Invalid card currency"+n(no!n currency

BC onversion rate not $ound

BC@ Invalid re'uest $ormatBCD Invalid hash in the re'uest

BCA &ther error

BBC Internal error

BBB +nsuorted card currency

Notes9

B# Some errors can have more in$ormative message# =or e>amle error !ith code

BC@ may have detailed in$ormation on !rong or e>ected tag7s8 in the 0M1#

5.1.5.2 eCC inormation in the *+, reuests

e5 enabled 0M1 re'uests must include =&?IGN+??NIN=&?M6TI&N tag

and it nested tags#

There is an e>amle o$ =oreign urrency in$ormation in the 0M1 ayment re'uest9

J=&?IGN+??NIN=&?M6TI&NKJ6?5+??NKGEPJ"6?5+??NK

J6?56M&+NTK#@J"6?56M&+NTKJ&N,?SI&N?6TKC#@B.@J"&N,?SI&N?6TK

J"=&?IGN+??NIN=&?M6TI&NK

5escrition o$ =&?IGN+??NIN=&?M6TI&N $ields9



N &uter tag $or urrency onversion ?atein$ormative $ields

6?5+??N ard*s currency code

6?56M&+NT 6mount !hich suosed to be chargedin the home currency



24/58

Pa e 24

&N,?SI&N?6T ,alue received in the onversion ?atere'uest should be there# Processingban( 7uroone>8 !ill declinetransaction i$ !rong rate !ill be there#

>amle o$ a Payment transaction !ith e59

JO>ml versionLB#C encodingL+T=-DOKJP6MNTK

J&?5?I5KBB.CBCA224.J"&?5?I5KJT?MIN61I5K4ABCC2J"T?MIN61I5K

J6M&+NTKBCJ"6M&[email protected]"56TTIMK

J6?5N+ME?K4BBBBBBBBBBBBBBBJ"6?5N+ME?KJ6?5TPK,IS6J"6?5TPK

J6?50PI?KCDC@J"6?50PI?KJ6?5/&15?N6MKoe EloggsJ"6?5/&15?N6MK

J/6S/KdC4c3bab.BACA.ecbC4e$$AB@22eDd$J"/6S/KJ+??NK+?J"+??NK

F;@-I=NC8--NCDIN;@-+#TI@NG

FC#-C8--NCDG='PFC#-C8--NCDGFC#-#+@8NTG!.!&FC#-#+@8NTGFC@N)-SI@N-#TG:.!!&15&FC@N)-SI@N-#TG

F;@-I=NC8--NCDIN;@-+#TI@NGJT?MIN61TPKBJ"T?MIN61TPK

JT?6NS6TI&NTPK@J"T?6NS6TI&NTPKJ,,K2B4J",,K

J"P6MNTK

>amle o$ an e5 Pre-6uth transaction9

JO>ml versionLB#C encodingL+T=DOKJP?6+T/K

J&?5?I5KBCCC2D3@43BAJ"&?5?I5K

JT?MIN61I5K4ABCC2J"T?MIN61I5KJ6M&+NTKB.#2J"6M&+NTKJ56TTIMKBD-B2-2CCD9CA9249B9BC.J"56TTIMKJ6?5N+ME?K4BBBBBBBBBBBBBBBJ"6?5N+ME?KJ6?5TPK,IS6J"6?5TPKJ6?50PI?KBBCAJ"6?50PI?KJ6?5/&15?N6MKoe EloggsJ"6?5/&15?N6MKJ/6S/KAc.DeDd@[email protected]"/6S/KJ+??NK+?J"+??NKF;@-I=NC8--NCDIN;@-+#TI@NG

FC#-C8--NCDG='PFC#-C8--NCDGFC#-#+@8NTG1:.42FC#-#+@8NTGFC@N)-SI@N-#TG:.!!&15&FC@N)-SI@N-#TG


JT?MIN61TPKBJ"T?MIN61TPKJT?6NS6TI&NTPK@J"T?6NS6TI&NTPKJ,,K2B4J",,K

J"P?6+T/K

>amle o$ out o$ B.R margin e5 Pre-6uth omletion transaction9

JO>ml versionLB#C encodingL+T=-DOKJP?6+T/&MP1TI&NK

J&?5?I5KBCCC2D3@4B23J"&?5?I5KJT?MIN61I5KBCCBJ"T?MIN61I5KJ6M&+NTK22#3DJ"6M&+NTKF;@-I=NC8--NCDIN;@-+#TI@NG

FC#-C8--NCDG='PFC#-C8--NCDGFC#-#[email protected]#-#+@8NTGFC@N)-SI@N-#TG:.!!&15&FC@N)-SI@N-#TG




25/58

Pa e 2.

[email protected]@J"56TTIMKJ,,[email protected]",,KJ/6S/K$$2eD4D.d@debb$C@d3d$e$$ad.DADcJ"/6S/K

J"P?6+T/&MP1TI&NK

Note% that foreign currenc infor*ation in the co*pletion re8uest is useful when

co*pleting an out of %= toleranceC transaction, !ecause the original pre'auth transaction will

!e reversed and a new )A.6#NT transaction will !e authoried instead, and the foreign

currenc details provided will !e used for the new transaction"

The original pre'auth eEchange rate is used when an eD++ transaction within the %=

tolerance is co*pleted

5.1.! )oiceI )oicePay

,oicePay lets your customers buy roducts online securely# 6ll they need is their

mobile hone# ,oiceay uses the cardholders o!n voice to authenticate every

transaction and since all o$ our voices are uni'ue this ma(es shoing !ith ,oicePay

comletely secure% and every transaction is guaranteed# More in$ormation can be $ound

here#

There are t!o tyes o$ ,oice veri$ication9

,oiceI5 veri$ies the users identity% but does not er$orm a transaction#

,oicePay veri$ies the users identity and uses it to authorise a transaction#

The $ollo!ing is a simle e>amle o$ a ,oiceI5 0M1 P&ST9


J,&II5?+STKJ&?5?I5K'>icD324hrtbJ"&?5?I5K

JT?MIN61I5KBCCAJ"T?MIN61I5KJ56TTIMKBA-C4-2CBB9BC949.@9CCCJ"56TTIMK

JM&[email protected]"M&EI1N+ME?KJM6I1Krandomemail#comJ"M6I1K

J/6S/KD.accbCD23Ca.dbAc2aAC@eeeJ"/6S/KJ5S?IPTI&NKSamle ,oiceI5 re'uestJ"5S?IPTI&NK

J",&II5?+STK

The $ollo!ing is a simle e>amle o$ a ,oicePay 0M1 P&ST9

JO>ml versionLB#C encodingL+T=-DOKJ,&II5?+STK

J&?5?I5Ka23t4va23dyJ"&?5?I5KJT?MIN61I5KBCCAJ"T?MIN61I5KJ56TTIMKBA-C4-2CBB9BC9439B39CCCJ"56TTIMKJM&[email protected]"M&EI1N+ME?KJM6I1Krandomemail#comJ"M6I1KJ,&II5P6MNTK

J6M&+NTK3C#CCJ"6M&+NTKJ+??NKGEPJ"+??NK

J",&II5P6MNTKJ/6S/K@$DDBDB$ae$Abb3B34DC$C4cJ"/6S/K

http://www.voice-pay.com/http://www.voice-pay.com/


26/58

Pa e 2

J5S?IPTI&NK&rder 5escJ"5S?IPTI&NKJ",&II5?+STK

6 resonse $or this transaction !ould be9

JO>ml versionLB#C encodingL+T=-DOKJ,&II5?SP&NSK

J?SP&NS&5K6J"?SP&NS&5K

J?SP&NST0TKS+SSJ"?SP&NST0TKJ&[email protected]@.J"&[email protected]"56TTIMKJ/6S/KaCaa$B4$e.3A$4dedd3C.4.DBBabJ"/6S/K

J",&II5?SP&NSK

The WorldNet TPS ayment system then handles subse'uent transaction settlement

and storage#

The $ollo!ing is a descrition o$ each $ield9


&?5?I5 The original order I5 o$ the transaction#T?MIN61I5 6 TerminalI5 rovided by WorldNet

TPS# NE Please contact WorldNet TPSto be issued !ith a test terminal I5#


M&EI1N+ME? The cardholders ,oiceI5 accountregistered hone number#

M6I1 The cardholders ,oiceI5 account emailaddress#

6M&+NT N The amount o$ the transaction as a 2

digits decimal or an Integer value $orP amounts#

+??N N 6 3 character currency code o$ thetransaction#

/6S/ 6n M5. hash# See note B belo!#

&P?6T&? 6n identi$ier $or !ho e>ecuted thistransaction

5S?IPTI&N N 6n otional descrition $or thetransaction#



?SP&NS&5 6 or 5 76roved or 5eclined8


&?5?I5 6 uni'ue identi$ier $or the order created bythe merchant#


/6S/ 6n M5. hash# See note 2 belo!#

Notes9




27/58

Pa e 2@

T?MIN61I5;&?5?I5;56TTIM;M&EI1N+ME?;M6I1;+??N;6M&+

NT;secret


?SP&NS&5;?SP&NST0T;&?5?I5;6M&+NT;+??N;56TTIM;secret

".2 3% Secure &or '() transact!ons *+ord,et TPS (P

To simli$y 35 Secure integration using 0M1 ayments% WorldNet TPS rovides a

simle MPI redirect# To allo! 35 Secure transactions $or a terminal it should be

con$igured and registered !ith the card schemes% lease contact the WorldNet TPS

suort team $or details#

The merchants alication should redirect the cardholder*s bro!ser to the +?19

htt$siry $ield 7MM8

6?5TP See section 3#2 above#6M&+NT The amount o$ the transaction as a 2 digit

decimal or an Integer value $or Pamounts#

+??N 6 3 character currency code o$ thetransaction#




Notes9



28/58

Pa e 2D


T?MIN61I5;&?5?I5;6?5N+ME?;6?50PI?;6?5TP;6M&+NT;56

TTIM;secret

The $ollo!ing arameter are returned to a merchant alication9


?S+1T MPI rocessing result9 6 6roved 5 5eclined

MPI?= MPI re$erence% this value should besent in the 0M1 ayment re'uest i$received $rom the WorldNet TPSMPI#

&?5?I5 &riginal order identi$ier



Notes9


?S+1T;MPI?=;&?5?I5;56TTIM;secret

6$ter the merchant alication !ill receives the 35 Secure chec( result% it should

send an 0M1 ayment re'uest# I$ the 35 Secure chec( !as success$ul 7H6* ?esult8 the

ayment re'uest should contain the $ields MPI?=% &rder I5 and Terminal I5 and they

should be the same as in the 35 Secure re'uest# I$ the 35 Secure chec( !as not

success$ul 7H5* ?esult8 the alication can send a non-35 Secure transaction 7MPI?=

!ill not be available in such case8 or don*t send ayment transaction at all# We

recommend that the transaction should be mar(ed as declined in your system i$ our

MPI reects the transaction#



29/58

Pa e 2A

! Secure Card Storage

Secure ard Storage is the storage o$ sensitive card in$ormation in the WorldNet

system $or use at a later date# It is a re'uirement $or Subscrition rocessing# It is

use$ul $or merchants that are re'uired to er$orm regular ayments !ithout the card

holder entering their in$ormation# &nly PI-5SS certi$ied merchants are allo!ed to

store card details themselves#

/.1 Secure Card #eg!strat!on and 0pdat!ng &rom the Hosted Page

Secure ard details can be registered or udated using the WorldNet TPS hosted

age by the cardholder% card details !ill be stored using WorldNet TPS Secure ard

Storage#

To initiate a Secure ard registration or udate a P&ST must be made to the

$ollo!ing +?19

htt$samle /TM1 $orm to oen card details registration age#

JhtmlKJbodyK

J$orm actionLhtts9""testayments#!orldnetts#com"merchant"securecardage methodLostKJinut tyeLhidden nameL6TI&N valueLregister "KJinut tyeLhidden nameLT?MIN61I5 valueL4ABCC2 "K



30/58

Pa e 3C

Jinut tyeLhidden nameLM?/6NT?= valueLB23432B "KJinut tyeLhidden nameL56TTIM valueLB.-C3-2CC9BC9439CB9@3 "KJinut tyeLhidden nameL/6S/ valueLd.d344B$bCeD3BDcedC3A@c2eA3@4A "KJinut tyeLsubmit valueL?egister "K

J"$ormKJ"bodyK

JhtmlK

To initiate card details updating, the value of the ACTION parameter should be changed to

update. A Secure Card of !"C#ANT"!$ %&'('&% must be alread) e*isting under )our account.

+lease note that the T!"INAI- here is not valid and must be changed.

Assuming valid details ere sent, the #osted "egistration or /pdate page ill be displa)ed,

clic0ing on "egister or /pdate ill save the card details, result 1!T parameters ill be forarded

to the Secure Card /" that is configured on the Terminal Setup page.

=ollo!ing arameters !ill be sent to the Secure ard ?eceit +?19


?SP&NS&5 ?esonse ode :6< - 6roval%chec( the ?esonse odes tablebelo! $or a $ull list o$ all suortedcodes#

?SP&NST0T ?esonse Te>t

M?/6NT?= &riginal Merchant ?e$erence#

6?5?=?N Generated ard ?e$erence

56TTIM =ormat9 55-MM-

9//9MM9SS9SSS/6S/ 6n M5. hash# See Note B belo!#

Notes9


T?MIN61I5;?SP&NS&5;?SP&NST0T;M?/6NT?=;6?5?=

?N;56TTIM;secret

?esonse odes9rror ode 5escrition

CB SSTM ??&? T? 6G6IN

C2 6?5 61?65 0ISTS

C3 &P?6TI&N N&T 611&W5

C4 IN,61I5 ?=?N 5T6I1S

C. IN,61I5 6?5 TP

C IN,61I5 T?MIN61I5

C@ MT/&5 N&T S+PP&?T5

CD IN,61I5 M?/6NT?=

CA IN,61I5 56TTIM

BC IN,61I5 6?5N+ME?



31/58

Pa e 3B

BB IN,61I5 6?50PI?

B2 IN,61I5 6?5/&15?N6M

B3 IN,61I5 /6S/

I$ invalid arameter values are sent% an rror Page !ill aear and the !eb bro!ser

!ill not be redirected to the Secure ard ?eceit Page# This should not haen in a

roduction environment a$ter integration is comleted#

/.2 '() Secure Card ntegrat!on

!.2.1 Secure Card etails -egistration and 8$dating

The $ollo!ing is an e>amle o$ a Secure ard 5etails ?egistration re'uest $or aterminal9

JO>ml versionLB#C encodingL+T=-DOKJS+?6?5?GIST?6TI&NK

JM?/6NT?=K@@CCBJ"M?/6NT?=KJT?MIN61I5K4ABCC2J"T?MIN61I5KJ56TTIMK3B-B2-2CCD9239.A9.A9CCBJ"56TTIMKJ6?5N+ME?K444433332222BBBBJ"6?5N+ME?KJ6?50PI?KB2CDJ"6?50PI?KJ6?5TPK,IS6J"6?5TPKJ6?5/&15?N6MKoe EloggsJ6?5/&15?N6MKJ/6S/KdC4c3bab.BACA.ecbC4e$$AB@22eDd$J"/6S/K

J"S+?6?5?GIST?6TI&NK

The $ollo!ing is an e>amle o$ a Secure ard 5etails +dating re'uest9


JS+?6?5+P56TKJM?/6NT?=K@@CCBJ"M?/6NT?=K

JT?MIN61I5K4ABCC2J"T?MIN61I5KJ56TTIMK3B-B2-2CCD9239.A9.A9CCBJ"56TTIMK

J6?5N+ME?K444433332222BBBBJ"6?5N+ME?KJ6?50PI?KB2CDJ"6?50PI?K

J6?5TPK,IS6J"6?5TPKJ6?5/&15?N6MKoe EloggsJ6?5/&15?N6MK

J/6S/KdC4c3bab.BACA.ecbC4e$$AB@22eDd$J"/6S/K

J"S+?6?5+P56TK

=ields descrition9


M?/6NT?= +ni'ue Merchant ?e$erence# 1ength islimited to 4D chars#



6?5N+ME? The ayment card number

6?50PI? 4 digit e>iry $ield 7MM8

6?5TP ard tye suorted by terminal6?5/&15?N6M ardholder name



32/58

Pa e 32


5&NT/FS+?IT N Send :< i$ you !ould not li(e ,, sentonline $or this registration#

,, N The security code entered by the cardholder# I$ sent 7and:5&NT/FS+?IT< not :


33/58

Pa e 33

rror handling

If card as not registered or updated, error code and error message ill be returned4

J??&?KJ??&?&5KCDJ"??&?&5KJ??&?ST?INGKIN,61I5 M?/6NT?=J"??&?ST?INGK

J"??&?K



??&?&5 rror code

??&?ST?ING Te>tual message

There is list o$ error codes and corresonding messages9

rror ode 5escrition


C2 6?5 61?65 0ISTS

C3 &P?6TI&N N&T 611&W5

C4 IN,61I5 ?=?N 5T6I1S

C. IN,61I5 6?5 TP

C IN,61I5 T?MIN61I5


CD IN,61I5 M?/6NT?=CA IN,61I5 56TTIM

BC IN,61I5 6?5N+ME?

BB IN,61I5 6?50PI?

B2 IN,61I5 6?5/&15?N6M

B3 IN,61I5 /6S/

!.2.2 Card etails -emo9al

ard details removal re'uest $ormat9

JO>ml versionLB#C encodingL+T=-DOKJS+?6?5?M&,61K

JM?/6NT?=K@@CCBJ"M?/[email protected]@@BA4@3J"6?5?=?NK

JT?MIN61I5K4ABCC2J"T?MIN61I5KJ56TTIMK3B-B2-2CCD9239.A9.A9CCBJ"56TTIMK

J/6S/KdC4c3bab.BACA.ecbC4e$$AB@22eDd$J"/6S/KJ"S+?6?5?M&,61K

=ields descrition9


M?/6NT?= +ni'ue Merchant ?e$erence# 1ength is



34/58

Pa e 34

limited to 4D chars#

6?5?=?N

System-Generated ard ?e$erence7Secure ard8




Notes9


T?MIN61I5;M?/6NT?=;56TTIM;6?5?=?N;secret

ard detail success$ul deletion resonse $ormat9

JS+?6?5?M&,61?SP&NSKJ56TTIMK3B-B2-2CCD9239.A9.A9CC2J"56TTIMK

J/6S/KdC4c3bab.BACA.ecbC4e$$AB@22eDd$J"/6S/KJ"S+?6?5?M&,61?SP&NSK

The $ollo!ing $ields !ill be returned in the resonse9




Notes9


T?MIN61I5;M?/6NT?=;56TTIM;secret

rrors handling

I$ re'uest !as not success$ul% error code and error message !ill be returned9

J??&?KJ??&?&5KCDJ"??&?&5K

J??&?ST?INGKIN,61I5 M?/6NT?=J"??&?ST?INGKJ"??&?K



??&?&5 rror code



rror ode 5escrition




35/58

Pa e 3.

C3 &P?6TI&N N&T 611&W5

C4 IN,61I5 ?=?N 5T6I1S

C IN,61I5 T?MIN61I5


CD IN,61I5 M?/6NT?=

B3 IN,61I5 /6S/

!.2.3 Card etails Search

Secure ard search by Merchant ?e$erence can be er$ormed as needed9

JO>ml versionLB#C encodingL+T=-DOKJS+?6?5S6?/K

JM?/6NT?=K@@CCBJ"M?/6NT?=KJT?MIN61I5K4ABCC2J"T?MIN61I5K

J56TTIMK3B-B2-2CCD9239.A9.A9CCBJ"56TTIMKJ/6S/KdC4c3bab.BACA.ecbC4e$$AB@22eDd$J"/6S/KJ"S+?6?5S6?/K

=ields descrition9






Notes9



Secure ard detail success$ul deletion resonse $ormat9

JS+?6?5S6?/?SP&NSKJM?/6NT?=K@@CCBJ"M?/[email protected]@C2B4A@BJ"6?5?=?NK

J6?5TPK,IS6J"6?5TPKJ6?50PI?KB2CDJ"6?50PI?KJ6?5/&15?N6MKoe EloggsJ6?5/&15?N6MKJ56TTIMK3B-B2-2CCD9239.A9.A9CCBJ"56TTIMKJ/6S/KdC4c3bab.BACA.ecbC4e$$AB@22eDd$J"/6S/K

J"S+?6?5S6?/?SP&NSK




6?5?=?N ard ?e$erence

6?5TP ard tye suorted by terminal

6?50PI? 4 digit e>iry $ield 7MM8



36/58

Pa e 3

6?5/&15?N6M ardholder name



Notes4

B# The -3 hash is generated using the folloing as an input string4T!"INAI-5!"C#ANT"!$5CA"-"!$!"!NC!5CA"-T6+!5CA"-!7+I"65CA

"-#O-!"NA!5-AT!TI!5secret

rrors handling

I$ re'uest !as not success$ul% error code and error message !ill be returned9

J??&?KJ??&?&5KC4J"??&?&5K

J??&?ST?INGKIN,61I5 ?=?N 5T6I1SJ"??&?ST?INGKJ"??&?K

The folloing fields are returned in the response if error has occurred4


??&?&5 rror code


There is list of error codes and corresponding messages4

rror ode 5escrition


C3 &P?6TI&N N&T 611&W5C4 IN,61I5 ?=?N 5T6I1S

C IN,61I5 T?MIN61I5


CD IN,61I5 M?/6NT?=

B3 IN,61I5 /6S/

!.2.4 *+, Payments using -egistered Card

To send a ayment transaction using a registered card% a standard P6MNT

re'uest should be sent# The ard Tye should be set to S+?6?5% the

6?5N+ME? should contain the Secure ard ?e$erence% both 6?50PI? and

6?5/&15?N6M tags should be omitted $rom the re'uest#



37/58

Pa e 3@

& Subscri$tions

WorldNet Subscritions is a versatile and comlete recurring ayments solution# It

can be used in t!o main !ays9

B# 6utomatic ayments - This is a $ully automated solution that !ill manage the

li$etime o$ a recurring ayment once it is registered and noti$y the merchant

o$ any issues that haen during its li$etime#

2# Manual ayments With this solution% recurring ayments are set u in our

system ust as they are $or automatic ayments# The main di$$erence is that

our system does not actually rocess ayments automatically# Instead% !hen

a ayment is ending% the merchant should initiate the ayment% either via

and :0M1 Payment ?e'uest< or through the Sel$are system# 6nother

di$$erence !ith this method is that you can modi$y the amount o$ the

ayment#

Subscritions can only be set u on card details already stored in our system using

the Secure ard $eature above# Subscritions are set u in t!o levels9

B# Stored Subscritions Stored subscritions are not subscritions in their o!n

right% but instead are temlates $or multile subscritions that are registered

under them# They de$ine the eriod 7daily " !ee(ly " monthly " 'uarterly "

annually8% the number o$ those eriods 7i$ its a $i>ed number8% setu rice%

recurring rice% etc# They are intended to reresent a roduct% $or e>amle#

2# Subscritions very subscrition set u has to be under a Stored

Subscrition# /o!ever some o$ the settings o$ the stored subscrition can be

overruled by the Subscrition itsel$% as you !ill see belo!# Subscritions are

intended to reresent a seci$ic order o$ a roduct reresented by the stored

subscrition that its under#

.1 Suscr!pt!on #eg!strat!on &rom the Hosted Page

Ne! Subscrition can be registered $rom the WorldNet TPS hosted age# When ne!

subscrition is created it name% descrition% set-u rice% recurring rice% length% eriod

tye and tye are coied $rom the corresonding stored subscrition%



38/58

Pa e 3D

To get Subscrition ?egistration Page oened in a client bro!ser a P&ST must be

made to the $ollo!ing +?19

htt$s


39/58

Pa e 3A

seturice% subscritionlength% eriodtye%tye $or all subscritions8

&N51T Integer code o$ ondelete9B - &NTIN+"2- 6N1 7ontinue subscritions untilcancelled manually or reach end date orlength " ancel all subscritions8

Notes9


T?MIN61I5;M?/6NT?=;S+?6?5M?/6NT?=;56TTIM;ST6?

T56T;secret

Eelo! is an e>amle /TM1 $orm to oen subscrition registration age#

JhtmlK

JbodyKJ$orm actionL:htts9""testayments#!orldnetts#com"merchant"subscritionage"registeramle o$ a Stored Subscrition +dating re'uest9

JO>ml versionLB#C encodingL+T=DOKJUPDATESTOREDSUBSCRIPTIONK

JM?/6NT?=KB323BJ"M?/6NT?=KJT?MIN61I5K4ABCC2J"T?MIN61I5KJ56TTIMK3B-C@-2CCA9B9C@92B9CCCJ"56TTIMKJN6MK6nimal 1i$eJ"N6MKJ5S?IPTI&NKMaga)ine membershiJ"5S?IPTI&NKJP?I&5TPKM&NT/1J"P?I&5TPKJ1NGT/KB2J"1NGT/KJ+??NK+?J"+??NK



41/58

Pa e 4B

J?+??ING6M&+NTKB.#AAJ"?+??ING6M&+NTKJINITI616M&+NTKBC#AAJ"INITI616M&+NTKJTPK6+T&M6TIJ"TPKJ&N+P56TK&NTIN+J"&N+P56TKJ&N51TK6N1J"&N51TKJ/6S/[email protected]@c@@$bBBbA4$J"/6S/K

J"UPDATESTOREDSUBSCRIPTIONK

=ields descrition9


M?/6NT?= +ni'ue merchant identi$ier er terminal#1ength is limited to 4D chars#



N6M 5islay name $or subscrition

5S?IPTI&N 5escrition e>laining subscrition

P?I&5TP Period Tye% can be9 56I1% WF1%

=&?TNIG/T1% M&NT/1% +6?T?1%6?1

1NGT/ C $or non ending " multilier o$ eriod# Thisdoes not ta(e e$$ect i$ 7Subscrition lengthU Period Tye8 K 7nd 5ate urrent 5ate8

+??N urrency o$ subscrition% this must eitherthe base currency o$ the terminal or i$suorted% one o$ the con$igured allo!edcurrencies

?+??ING6M&+NT ost o$ each ayment 7!ill be ignored i$manual8

INITI616M&+NT Initial 7set-u8 ayment to be ta(en o$$card# Payment !ill not be ta(en i$ it is C#

TP M6N+61 " 6+T&M6TI " 6+T&M6TI7WIT/&+T 6M&+NTS8

&N+P56T +P56T"&NTIN+ 7+date name%descrition% recurringrice% seturice%subscritionlength% eriodtye% tye $or allsubscritions"1et them $inish theirsubscrition rior to udate8

&N51T 6N1"&NTIN+ 7ancel all subscritions" ontinue subscritions until cancelledmanually or reach end date or length8


Notes9


T?MIN61I5;M?/6NT?=;56TTIM;TP;N6M;P?I&5TP;+??

N;?+??ING6M&+NT;INITI616M&+NT;1NGT/;secret

I$ ne! stored subscrition !as success$ully registered% resonse !ould be9



42/58

Pa e 42

JADDSTOREDSUBSCRIPTIONRESPONSEKJM?/6NT?=KB323BJ"M?/[email protected]@4.J"56TTIMKJ/6S/KdC4c3bab.BACA.ecbC4e$$AB@22eDd$J"/6S/K

J"ADDSTOREDSUBSCRIPTIONRESPONSEK

>amle o$ a success$ul stored subscrition udating resonse9

JUPDATESTOREDSUBSCRIPTIONRESPONSEKJM?/6NT?=KB323BJ"M?/6NT?=KJ56TTIMK3B-C@-2CCA9B9C@92B932AJ"56TTIMKJ/6S/KCa$4ABcadC$dBeBAbc@CAde@d@cA34J"/6S/K

J"UPDATESTOREDSUBSCRIPTIONRESPONSEK



M?/6NT?= &riginal Merchant ?e$erence sent inregistration re'uest



Notes9



rrors handling

I$ stored subscrition !as not registered or udated% error code and error message

!ill be returned9

J??&?KJ??&?&5KCDJ"??&?&5K




??&?&5 rror code


Stored Subscrition creation and udating error codes9

rror ode 5escrition


C3 &P?6TI&N N&T 611&W5

C IN,61I5 T?MIN61I5


CD IN,61I5 M?/6NT?=

CA IN,61I5 56TTIM

B3 IN,61I5 /6S/

2C IN,61I5 1NGT/2B IN,61I5 P?I&5 TP



43/58

Pa e 43

22 IN,61I5 N6M

23 IN,61I5 5S?IPTI&N

24 IN,61I5 ?+??ING6M&+NT

2. IN,61I5 INITI616M&+NT

2 IN,61I5 TP

2@ IN,61I5 &N+P56T

2D IN,61I5 &N51T

2A IN,61I5 T?MIN61 +??N

&.2.2 Stored Subscri$tion eletion -euest

To delete stored subscription folloing 7 1atea) re8uest should be send4

JO>ml versionLB#C encodingL+T=DOKJ51TST&?5S+ES?IPTI&NK

JM?/6NT?=KB323BJ"M?/6NT?=KJT?MIN61I5K4ABCC2J"T?MIN61I5KJ56TTIMK3B-C@-2CCA92C94A9349@ADJ"56TTIMKJ/6S/Ke$c.aC4b.aADbeAbd.Aec.3D3abbABBJ"/6S/K

J"51TST&?5S+ES?IPTI&NK

$ields description4






Notes9



>amle o$ a success$ul stored subscrition deletion resonse9

J51TST&?5S+ES?IPTI&N?SP&NSK

JM?/6NT?=KB323BJ"M?/[email protected]"56TTIMK

J/6S/KDaD$422@[email protected]$BDd@dcJ"/6S/KJ"DEETESTOREDSUBSCRIPTIONRESPONSEK



M?/6NT?= &riginal Merchant ?e$ernce sent inregistration re'uest



Notes9




44/58

Pa e 44


rrors handling

I$ stored subscrition !as not registered or udated% error code and error message

!ill be returned9J??&?K

J??&?&5KCDJ"??&?&5K




??&?&5 rror code



rror ode 5escrition


C3 &P?6TI&N N&T 611&W5

C IN,61I5 T?MIN61I5


CD IN,61I5 M?/6NT?=

CA IN,61I5 56TTIM

B3 IN,61I5 /6S/

&.2.3 Subscri$tion Creation -euest

ach subscrition should be created based on some stored subscrition# When ne!

subscrition is created it name% descrition% set-u rice% recurring rice% length% eriod

tye and tye are coied $rom the corresonding stored subscrition% most subscrition

$ields can be changed by Subscrition +dating re'uest#

To create ne! subscrition based on an e>isting Stored Subscrition $ollo!ing 0M1

Gate!ay re'uest should be sent9

JO>ml versionLB#C encodingL+T=DOKJ655S+ES?IPTI&NK JM?/6NT?=KM?CB-C2J"M?/6NT?=K JT?MIN61I5K4ABCC2J"T?MIN61I5K JSTOREDSUBSCRIPTIONREFKM?CBJ"STOREDSUBSCRIPTIONREFK JSECURECARD!ERCHANTREFK@B2J"SECURECARD!ERCHANTREFK [email protected]@BJ"56TTIMK JSTARTDATEKCB-CD-2CCAJ"STARTDATEK

JENDDATEK3B-C@-2CBCJ"ENDDATEK JEDCCDECISIONKJ"EDCCDECISIONK J/6S/KD.B.ccc.C..BcB2abC4.$@AebC2@BJ"/6S/K



45/58

Pa e 4.

J"655S+ES?IPTI&NK

I$ Stored Subscrition doesnt yet e>ist it can be created utting all it details into

the nested NWST&?5S+ES?IPTI&NIN=& tag% ST&?5S+ES?IPTI&N?= in such

case should be omitted# There is e>amle o$ such re'uest9

JO>ml versionLB#C encodingL+T=DOKJ655S+ES?IPTI&NK

JM?/6NT?=KM?C2-C2J"M?/6NT?=KJT?MIN61I5K4ABCC2J"T?MIN61I5KJSECURECARD!ERCHANTREFK@B2J"[email protected]@BJ"56TTIMKJSTARTDATEKCB-CD-2CCAJ"STARTDATEKJENDDATEK3B-C@-2CBCJ"ENDDATEKJEDCCDECISIONKJ"EDCCDECISIONKF,+ST#%S0BSC#PT,,5G

F+-C"#NT-;G+-::1F+-C"#NT-;GFN#+G#nimal ,ieFN#+GFSC-IPTI@NG+agaHine membershi$FSC-IPTI@NGFP-I@TDPG+@NT",DFP-I@TDPG

F,N=T"G12F,N=T"GFC8--NCDG8-FC8--NCDGF-C8--IN=#+@8NTG15./&F-C8--IN=#+@8NTGFINITI#,#+@8NTG1:.00FINITI#,#+@8NTGFTDPG#8T@+#TICFTDPGF@N8P#TGC@NTIN8F@N8P#TGF@N,TGC#NC,F@N,TG

F,+ST#%S0BSC#PT,,5GJ/6S/KD.B.ccc.C..BcB2abC4.$@AebC2@BJ"/6S/K

J"655S+ES?IPTI&NK

=ields descrition9

=ield Name ?e'uired 5escritionM?/6NT?= +ni'ue merchant identi$ier er terminal# 1ength

is limited to 4D chars#


ST&?5S+ES?IPTI&N?=

N Stored Subscrition Merchant ?e$erence% it isallo!ed only i$ NE"STOREDSUBSCRIPTIONINFOdo not #resent$

S+?6?5M?/6NT?=

Merchant ?e$erence o$ a Sucre ard !hich !illbe used to do set-u and recurring ayments


ST6?T56T Subscrition Start 5ate# =ormat9 55-MM-N556T N Subscrition nd 5ate% i$ it is not set

subscrition !ill continue until manuallycanceled or lenght reached 7i$ it is set8# =ormat955-MM-

55ISI&N N This $ield is suorted by a e5-enabledterminals only and !ill be ignored i$ terminaldoesnt suorts e5# an be :< or :N


46/58

Pa e 4

'%e'- NE"STOREDSUBSCRIPTIONINFO )ie&dsdes'ri#tion ta(&e )or detai&s$


Notes9


T?MIN61I5;M?/6NT?=;ST&?5S+ES?IPTI&N?=;S+?6?5M?

/6NT?=;56TTIM;ST6?T56T;secret

2# ST&?5S+ES?IPTI&N?= should be omitted i$ it is not set#

NE"STOREDSUBSCRIPTIONINFO )ie&ds des'ri#tion9



N6M 5islay name $or subscrition

5S?IPTI&N 5escrition e>laining subscrition

P?I&5TP Period Tye% can be9 56I1% WF1%=&?TNIG/T1% M&NT/1% +6?T?1%6?1

1NGT/ C $or non ending " multilier o$ eriod# Thisdoes not ta(e e$$ect i$ 7Subscrition length UPeriod Tye8 K 7nd 5ate urrent 5ate8

+??N urrency o$ subscrition% this must eitherthe base currency o$ the terminal or i$suorted% one o$ the con$igured allo!edcurrencies

?+??ING6M&+NT N ost o$ each ayment 7should not be sent i$TP is :M6N+61


47/58

Pa e 4@






Notes9



rrors handling

I$ ne! subscrition !as not registered% error code and error message !ill be

returned9


J"??&?K



??&?&5 rror code


Subscrition creation and udating error codes9

rror ode 5escrition


C3 &P?6TI&N N&T 611&W5

C IN,61I5 T?MIN61I5


CD IN,61I5 M?/6NT?=

CA IN,61I5 56TTIM

B3 IN,61I5 /6S/

2C IN,61I5 1NGT/2B IN,61I5 P?I&5 TP

22 IN,61I5 N6M

23 IN,61I5 5S?IPTI&N

24 IN,61I5 ?+??ING6M&+NT

2. IN,61I5 INITI616M&+NT

2 IN,61I5 TP

2@ IN,61I5 &N+P56T

2D IN,61I5 &N51T

2A IN,61I5 T?MIN61 +??N

3C IN,61I5 ST&?5 S+ES?IPTI&N ?=

3B IN,61I5 ST&?5 S+ES?IPTI&N M?/6NT ?=



48/58

Pa e 4D

32 IN,61I5 S+? 6?5 M?/6NT ?=

33 IN,61I5 ST6?T56T

34 IN,61I5 N556T

3. IN,61I5 55ISI&N

3 ST+P P6MNT P?&SSING ??&?

&.2.4 Subscri$tion 8$dating -euest

The $ollo!ing is an e>amle o$ a Subscrition +dating re'uest9

JO>ml versionLB#C encodingL+T=DOKJUPDATESUBSCRIPTIONK

JM?/6NT?=KM?CCBJ"M?/6NT?=KJT?MIN61I5K4ABCC2J"T?MIN61I5KJSECURECARD!ERCHANTREFKD32DJ"[email protected]"56TTIMK

JN6MK6nimal 1i$eJ"N6MKJ5S?IPTI&NKMaga)ine membershiJ"5S?IPTI&NKJP?I&5TPKM&NT/1J"P?I&5TPKJ1NGT/KB2J"1NGT/KJ?+??ING6M&+NTKB.#D@J"?+??ING6M&+NTKJSTARTDATEK23-CD-2CCAJ"STARTDATEKJENDDATEK22-CD-2CBCJ"ENDDATEKJEDCCDECISIONKJ"EDCCDECISIONKJ/6S/K.3bAB@aacDebB@[email protected]$d.cJ"/6S/K

J"UPDATESUBSCRIPTIONK

=ields descrition9

=ield Name ?e'uired 5escritionM?/6NT?= Merchant ?e$ o$ subscrition !hichshould be udated

T?MIN61I5 6 TerminalI5 rovided by WorldNetTPS#

S+?6?5M?/6NT?=

Merchant ?e$erence o$ a Sucre ard!hich !ill be used to do recurringayments


N6M N Subscrition Name

5S?IPTI&N N Subscrition 5escritionP?I&5TP N Ne! Period Tye

1NGT/ N Subscrition 1ength

?+??ING6M&+NT N Ne! ?ecurring 6mount

ST6?T56T N Subscrition Start 5ate

N556T N Subscrition nd 5ate% i$ it is not setsubscrition !ill continue untilmanually canceled or lenght reached7i$ it is set8

55ISI&N N This $ield is suorted by a e5-

enabled terminals only and !ill beignored i$ terminal doesnt suortse5# an be :< or :N


49/58

Pa e 4A


Notes9


T?MIN61I5;M?/6NT?=;S+?6?5M?/6NT?=;56TTIM;ST6?

T56T;secret

>amle o$ a success$ul subscrition udating resonse9

J+P56TS+ES?IPTI&N?SP&NSKJM?/6NT?=KM?C2-C2J"M?/6NT?=K

[email protected]"56TTIMKJ/6S/KDbb3Abe@aB$C.b$@3$e334eB2C3@2.@J"/6S/K

J"UPDATESUBSCRIPTIONRESPONSEK


=ield Name 5escritionM?/6NT?= &riginal Merchant ?e$erence sent in

registration re'uest



Notes9



rrors handling

I$ subscrition !as not udated% error code and error message !ill be returned9


J"??&?K


=ield Name 5escrition??&?&5 rror code


Possible error codes are covered I the Subscrition creation and udating error

codes#

&.2.5 Subscri$tion eletion -euest

The $ollo!ing is an e>amle o$ a Subscrition 5eletion re'uest9



50/58

Pa e .C

JO>ml versionLB#C encodingL+T=DOKJDEETESUBSCRIPTIONK

JM?/6NT?=KM?CC2J"M?/6NT?=KJT?MIN61I5K4ABCC2J"T?MIN61I5KJSECURECARD!ERCHANTREFKD32DJ"SECURECARD!ERCHANTREFKJ56TTIMK3B-C@-2CCA9BB9C3942932DJ"56TTIMKJ/6S/K.3bAB@aacDebB@[email protected]$d.cJ"/6S/K

J"DEETESUBSCRIPTIONK

=ields descrition9


M?/6NT?= Merchant ?e$ o$ subscrition !hich shouldbe deleted




Notes9



>amle o$ a success$ul subscrition deletion resonse9

J51TS+ES?IPTI&N?SP&NSKJM?/6NT?=KM?C2-C2J"M?/[email protected]"56TTIMKJ/6S/KDbb3Abe@aB$C.b$@3$e334eB2C3@2.@J"/6S/K

J"DEETESUBSCRIPTIONRESPONSEK






Notes9



rrors handling

I$ subscrition !as not deleted% error code and error message !ill be returned9

J??&?K

J??&?&5KCDJ"??&?&5KJ??&?ST?INGKIN,61I5 M?/6NT?=J"??&?ST?INGK

J"??&?K





51/58

Pa e .B

??&?&5 rror code


Possible error codes are covered I the Subscrition creation and udating error

codes#

&.2.! Subscri$tion Payment -euest

Manual subscrition recurring ayment can be done $rom the 0M1 Gate!ay# I$

automatic subscrition !as not aid automatically because o$ card details e>iration or

other issue it also can be aid in the same !ay as manual a$ter Secure ard issue !as

solved# The $ollo!ing is an e>amle o$ a Subscrition Payment re'uest9

JO>ml versionLB#C encodingL+T=DOKJSUBSCRIPTIONPA.!ENTK

JORDERIDKD32J"ORDERIDKJT?MIN61I5K4ABCC2J"T?MIN61I5KJA!OUNTKD@#@DJ"A!OUNTKJSUBSCRIPTIONREFK3BBJ"SUBSCRIPTIONREFKJFOREI/NCURRENC.INFOR!ATIONKJ6?5+??NKPJ"6?5+??NKJ6?56M&+NTKBC3DJ"6?56M&+NTKJ&N,?SI&N?6TKB2B#BDBACJ"&N,?SI&N?6TKJ"FOREI/[email protected]"56TTIMKJM6I1Kcardholderemail!orldnetts#comJ"M6I1K

J/6S/K.3bAB@aacDebB@[email protected]$d.cJ"/6S/KJ"SUBSCRIPTIONPA.!ENTK

=ields descrition9


&?5?I5 6 uni'ue identi$ier $or the ordercreated by the merchant# 7Ma> B2haracters8

T?MIN61I5 6 TerminalI5 rovided by WorldNetTPS# NE Please contact WorldNet

TPS to be issued !ith a testterminal I5#

6M&+NT The amount o$ the transaction as a2 digit decimal or an Integer value$or P amounts#

S+ES?IPTI&N?= Merchant re$erence o$ a subscritionbeing aid

5S?IPTI&N N Transaction 5escrition


N It is acceted $or e5 enabledsubscritions only#


M6I1 N ardholder e-mail address



52/58

Pa e .2


Notes9


T?MIN61I5;&?5?I5;S+ES?IPTI&N?=;6M&+NT;56TTIM;secret

2# B# =&?IGN+??NIN=&?M6TI&N tag re'uires intter e5 tags lease

chec( rror9 ?e$erence source not $ound $or details#

>amle o$ a success$ul subscrition ayment resonse9

JS+ES?IPTI&NP6MNT?SP&NSKJRESPONSECODEK6J"RESPONSECODEKJRESPONSETE0TK6PP?&,61J"RESPON

net payment guide

Documents

Transcript of net payment guide