net payment guide
TRANSCRIPT
-
8/21/2019 net payment guide
1/58
WorldNet TPS
Merchant Integration Guide
-
8/21/2019 net payment 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.
-
8/21/2019 net payment guide
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/
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.
-
8/21/2019 net payment guide
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#
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.
mailto:[email protected]:[email protected] -
8/21/2019 net payment guide
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#
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.
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 -
8/21/2019 net payment guide
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#
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.
http://www.worldnettps.com/sites/default/files/pdfs/Testing%20Guide.pdfhttp://www.worldnettps.com/sites/default/files/pdfs/Testing%20Guide.pdf -
8/21/2019 net payment guide
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/21/2019 net payment guide
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
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.
-
8/21/2019 net payment guide
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
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.
http://www.iso.org/iso/english_country_names_and_code_elementshttp://www.iso.org/iso/english_country_names_and_code_elements -
8/21/2019 net payment guide
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
B# The M5. hash is generated using the $ollo!ing as an inut string9
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#
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.
-
8/21/2019 net payment guide
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#
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.
https://testpayments.worldnettps.com/merchant/preauthpagehttps://testpayments.worldnettps.com/merchant/preauthpage -
8/21/2019 net payment guide
12/58
Pa e B2
The $ollo!ing arameters are sent in the validation re'uest9
=ield Name ?e'uired 5escrition
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
/6S/ 6n M5. hash# See Note B belo!#
ustomParameters
N on$igured Terminal ustom Parameters
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;&?5?I5;6M&+NT;56TTIM;?SP&NS&5;?SP&NST0T
;secret
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.
-
8/21/2019 net payment guide
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
-
8/21/2019 net payment guide
14/58
Pa e B4
Payment re'uest $ields descrition9
=ield Name ?e'uired 5escrition
&?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
/6S/ 6n M5. hash# See Note B belo!#
+??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#
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.
-
8/21/2019 net payment guide
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
=ield Name 5escrition
?SP&NS&5 6 or 5 or ? 76roved or 5eclined or ?e$erral8
?SP&NST0T The te>t o$ the authori)ation
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
B# The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;&?5?I5;6M&+NT;56TTIM;secret
2# The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;&?5?I5;6M&+NT;56TTIM;?SP&NS&5 ;?SP&NST0T
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.
http://www.iso.org/iso/english_country_names_and_code_elementshttp://www.iso.org/iso/english_country_names_and_code_elements -
8/21/2019 net payment guide
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#
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.
-
8/21/2019 net payment guide
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
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
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.
-
8/21/2019 net payment guide
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
=or testing% this 0M1 is osted to9
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
=ield Name ?e'uired 5escrition
&?5?I5 6 uni'ue identi$ier $or the order created bythe merchant# 7Ma> B2 haracters8
T?MIN61I5 6 TerminalI5 rovided by WorldNet TPS#
6M&+NT The amount o$ the transaction as a 2 digitdecimal or an integer value $or Pamounts#
=&?IGN+??NIN=&?M6TI&N
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
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.
-
8/21/2019 net payment guide
19/58
Pa e BA
The $ollo!ing $ields are returned in the resonse9
=ield Name 5escrition
?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
T?MIN61I5;&?5?I5;6M&+NT;56TTIM;?SP&NS&5 ;?SP&NST0T
;secret
rrors 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#
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
=or testing% this 0M1 is osted to9
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.
-
8/21/2019 net payment guide
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
=ield Name ?e'uired 5escrition
&?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
The $ollo!ing $ields are returned in the resonse9
=ield Name 5escrition
?SP&NS&5 6 or 5 76roved or 5eclined8
?SP&NST0T The te>t o$ the authori)ation
&?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#
56TTIM =ormat 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See note 2 belo!#
Notes9
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.
-
8/21/2019 net payment guide
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
28 The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;&?5?I5;6M&+NT;56TTIM;?SP&NS&5 ;?SP&NST0T
;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
=ield Name ?e'uired 5escrition
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
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.
-
8/21/2019 net payment guide
22/58
Pa e 22
56TTIM ?e'uest 5ate and Time# =ormat955-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See Note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
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
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.
-
8/21/2019 net payment guide
23/58
Pa e 23
tags#
The $ollo!ing $ields are returned in the resonse i$ error has occurred9
=ield Name 5escrition
??&?&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
=ield Name ?e'uired 5escrition
=&?IGN+??NIN=&?M6TI&N
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
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.
-
8/21/2019 net payment guide
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
F;@-I=NC8--NCDIN;@-+#TI@NG
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
F;@-I=NC8--NCDIN;@-+#TI@NG
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.
-
8/21/2019 net payment guide
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
JO>ml versionLB#C encodingL+T=-DOK
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
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.
http://www.voice-pay.com/http://www.voice-pay.com/ -
8/21/2019 net payment guide
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
=ield Name ?e'uired 5escrition
&?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#
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
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#
The $ollo!ing $ields are returned in the resonse9
=ield Name 5escrition
?SP&NS&5 6 or 5 76roved or 5eclined8
?SP&NST0T The te>t o$ the authori)ation
&?5?I5 6 uni'ue identi$ier $or the order created bythe merchant#
56TTIM =ormat 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See note 2 belo!#
Notes9
B8 The M5. hash is generated using the $ollo!ing as an inut string9
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.
-
8/21/2019 net payment guide
27/58
Pa e 2@
T?MIN61I5;&?5?I5;56TTIM;M&EI1N+ME?;M6I1;+??N;6M&+
NT;secret
28 The M5. hash is generated using the $ollo!ing as an inut string9
?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#
&?5?I5 6 uni'ue identi$ier $or the order created bythe merchant# 7Ma> B2 haracters8
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See Note B belo!#
Notes9
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.
-
8/21/2019 net payment guide
28/58
Pa e 2D
B8 The M5. hash is generated using the $ollo!ing as an inut string9
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
=ield Name ?e'uired 5escrition
?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
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See Note B belo!#
Notes9
B8 The M5. hash is generated using the $ollo!ing as an inut string9
?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#
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.
-
8/21/2019 net payment guide
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
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.
-
8/21/2019 net payment guide
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
=ield Name ?e'uired 5escrition
?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
B# The M5. hash is generated using the $ollo!ing as an inut string9
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?
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.
-
8/21/2019 net payment guide
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
JO>ml versionLB#C encodingL+T=-DOK
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
=ield Name ?e'uired 5escrition
M?/6NT?= +ni'ue Merchant ?e$erence# 1ength islimited to 4D chars#
T?MIN61I5 6 TerminalI5 rovided by WorldNet TPS#
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
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
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.
-
8/21/2019 net payment guide
32/58
Pa e 32
/6S/ 6n M5. hash# See note B belo!#
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 :
-
8/21/2019 net payment guide
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
The $ollo!ing $ields are returned in the resonse i$ error has occurred9
=ield Name 5escrition
??&?&5 rror code
??&?ST?ING Te>tual message
There is list o$ error codes and corresonding messages9
rror 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?
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
=ield Name ?e'uired 5escrition
M?/6NT?= +ni'ue Merchant ?e$erence# 1ength is
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.
-
8/21/2019 net payment guide
34/58
Pa e 34
limited to 4D chars#
6?5?=?N
System-Generated ard ?e$erence7Secure ard8
T?MIN61I5 6 TerminalI5 rovided by WorldNet TPS#
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
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
=ield Name 5escrition
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See Note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
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
The $ollo!ing $ields are returned in the resonse i$ error has occurred9
=ield Name 5escrition
??&?&5 rror code
??&?ST?ING Te>tual message
There is list o$ error codes and corresonding messages9
rror ode 5escrition
CB SSTM ??&? T? 6G6IN
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.
-
8/21/2019 net payment guide
35/58
Pa e 3.
C3 &P?6TI&N N&T 611&W5
C4 IN,61I5 ?=?N 5T6I1S
C IN,61I5 T?MIN61I5
C@ MT/&5 N&T S+PP&?T5
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
=ield Name ?e'uired 5escrition
M?/6NT?= +ni'ue Merchant ?e$erence# 1ength islimited to 4D chars#
T?MIN61I5 6 TerminalI5 rovided by WorldNet TPS#
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;M?/6NT?=;56TTIM;secret
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
The $ollo!ing $ields !ill be returned in the resonse9
=ield Name ?e'uired 5escrition
M?/6NT?= +ni'ue Merchant ?e$erence# 1ength islimited to 4D chars#
6?5?=?N ard ?e$erence
6?5TP ard tye suorted by terminal
6?50PI? 4 digit e>iry $ield 7MM8
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.
-
8/21/2019 net payment guide
36/58
Pa e 3
6?5/&15?N6M ardholder name
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See note B belo!#
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
=ield Name 5escrition
??&?&5 rror code
??&?ST?ING Te>tual message
There is list of error codes and corresponding messages4
rror ode 5escrition
CB SSTM ??&? T? 6G6IN
C3 &P?6TI&N N&T 611&W5C4 IN,61I5 ?=?N 5T6I1S
C IN,61I5 T?MIN61I5
C@ MT/&5 N&T S+PP&?T5
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#
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.
-
8/21/2019 net payment guide
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%
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.
-
8/21/2019 net payment guide
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
-
8/21/2019 net payment guide
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
B# The M5. hash is generated using the $ollo!ing as an inut string9
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
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.
-
8/21/2019 net payment guide
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
=ield Name ?e'uired 5escrition
M?/6NT?= +ni'ue merchant identi$ier er terminal#1ength is limited to 4D chars#
T?MIN61I5 6 TerminalI5 rovided by WorldNet TPS#
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
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
/6S/ 6n M5. hash# See note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
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
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.
-
8/21/2019 net payment guide
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
The $ollo!ing $ields !ill be returned in the resonse9
=ield Name 5escrition
M?/6NT?= &riginal Merchant ?e$erence sent inregistration re'uest
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See Note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;M?/6NT?=;56TTIM;secret
rrors handling
I$ stored subscrition !as not registered or udated% error code and error message
!ill be returned9
J??&?KJ??&?&5KCDJ"??&?&5K
J??&?ST?INGKIN,61I5 M?/6NT?=J"??&?ST?INGKJ"??&?K
The $ollo!ing $ields are returned in the resonse i$ error has occurred9
=ield Name 5escrition
??&?&5 rror code
??&?ST?ING Te>tual message
Stored Subscrition creation and udating error codes9
rror ode 5escrition
CB SSTM ??&? T? 6G6IN
C3 &P?6TI&N N&T 611&W5
C IN,61I5 T?MIN61I5
C@ MT/&5 N&T S+PP&?T5
CD IN,61I5 M?/6NT?=
CA IN,61I5 56TTIM
B3 IN,61I5 /6S/
2C IN,61I5 1NGT/2B IN,61I5 P?I&5 TP
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.
-
8/21/2019 net payment guide
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
=ield Name ?e'uired 5escrition
M?/6NT?= +ni'ue merchant identi$ier er terminal#1ength is limited to 4D chars#
T?MIN61I5 6 TerminalI5 rovided by WorldNet TPS#
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;M?/6NT?=;56TTIM;secret
>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
The $ollo!ing $ields !ill be returned in the resonse9
=ield Name 5escrition
M?/6NT?= &riginal Merchant ?e$ernce sent inregistration re'uest
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See Note B belo!#
Notes9
B8 The M5. hash is generated using the $ollo!ing as an inut string9
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.
-
8/21/2019 net payment guide
44/58
Pa e 44
T?MIN61I5;M?/6NT?=;56TTIM;secret
rrors handling
I$ stored subscrition !as not registered or udated% error code and error message
!ill be returned9J??&?K
J??&?&5KCDJ"??&?&5K
J??&?ST?INGKIN,61I5 M?/6NT?=J"??&?ST?INGKJ"??&?K
The $ollo!ing $ields are returned in the resonse i$ error has occurred9
=ield Name 5escrition
??&?&5 rror code
??&?ST?ING Te>tual message
There is list o$ error codes and corresonding messages9
rror ode 5escrition
CB SSTM ??&? T? 6G6IN
C3 &P?6TI&N N&T 611&W5
C IN,61I5 T?MIN61I5
C@ MT/&5 N&T S+PP&?T5
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
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.
-
8/21/2019 net payment guide
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#
T?MIN61I5 6 TerminalI5 rovided by WorldNet TPS#
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
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
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
-
8/21/2019 net payment guide
46/58
Pa e 4
'%e'- NE"STOREDSUBSCRIPTIONINFO )ie&dsdes'ri#tion ta(&e )or detai&s$
/6S/ 6n M5. hash# See note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
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
=ield Name ?e'uired 5escrition
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 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
-
8/21/2019 net payment guide
47/58
Pa e 4@
The $ollo!ing $ields !ill be returned in the resonse9
=ield Name 5escrition
M?/6NT?= &riginal Merchant ?e$erence sent inregistration re'uest
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See Note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;M?/6NT?=;56TTIM;secret
rrors handling
I$ ne! subscrition !as not registered% error code and error message !ill be
returned9
J??&?KJ??&?&5KCDJ"??&?&5KJ??&?ST?INGKIN,61I5 M?/6NT?=J"??&?ST?INGK
J"??&?K
The $ollo!ing $ields are returned in the resonse i$ error has occurred9
=ield Name 5escrition
??&?&5 rror code
??&?ST?ING Te>tual message
Subscrition creation and udating error codes9
rror ode 5escrition
CB SSTM ??&? T? 6G6IN
C3 &P?6TI&N N&T 611&W5
C IN,61I5 T?MIN61I5
C@ MT/&5 N&T S+PP&?T5
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 ?=
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.
-
8/21/2019 net payment guide
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
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
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
-
8/21/2019 net payment guide
49/58
Pa e 4A
/6S/ 6n M5. hash# See note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
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
The $ollo!ing $ields !ill be returned in the resonse9
=ield Name 5escritionM?/6NT?= &riginal Merchant ?e$erence sent in
registration re'uest
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See Note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;M?/6NT?=;56TTIM;secret
rrors handling
I$ subscrition !as not udated% error code and error message !ill be returned9
J??&?KJ??&?&5KCDJ"??&?&5KJ??&?ST?INGKIN,61I5 M?/6NT?=J"??&?ST?INGK
J"??&?K
The $ollo!ing $ields are returned in the resonse i$ error has occurred9
=ield Name 5escrition??&?&5 rror code
??&?ST?ING Te>tual message
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
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.
-
8/21/2019 net payment guide
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
=ield Name ?e'uired 5escrition
M?/6NT?= Merchant ?e$ o$ subscrition !hich shouldbe deleted
T?MIN61I5 6 TerminalI5 rovided by WorldNet TPS#
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;M?/6NT?=;56TTIM;secret
>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
The $ollo!ing $ields !ill be returned in the resonse9
=ield Name 5escrition
M?/6NT?= &riginal Merchant ?e$erence sent inregistration re'uest
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
/6S/ 6n M5. hash# See Note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
T?MIN61I5;M?/6NT?=;56TTIM;secret
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
The $ollo!ing $ields are returned in the resonse i$ error has occurred9
=ield Name 5escrition
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.
-
8/21/2019 net payment guide
51/58
Pa e .B
??&?&5 rror code
??&?ST?ING Te>tual message
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
=ield Name ?e'uired 5escrition
&?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
=&?IGN+??NIN=&?M6TI&N
N It is acceted $or e5 enabledsubscritions only#
56TTIM =ormat9 55-MM-9//9MM9SS9SSS
M6I1 N ardholder e-mail address
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.
-
8/21/2019 net payment guide
52/58
Pa e .2
/6S/ 6n M5. hash# See note B belo!#
Notes9
B# The M5. hash is generated using the $ollo!ing as an inut string9
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