Documente Academic
Documente Profesional
Documente Cultură
Merchant API
Version 1.4
2
DreamOval Ltd
Tema
Ghana
Email: info@dreamoval.com
DreamOval, has made efforts to ensure the accuracy and completeness of the
information in this document. However, DreamOval Ltd. makes no warranties of any
kind (whether express, implied or statutory) with respect to the information contained
herein. DreamOval assumes no liability to any party for any loss or damage (whether
direct or indirect) caused by any errors, omissions, or statements of any kind
contained in this document.
Further, DreamOval assumes no liability arising from the application or use of the
product or service described herein and specifically disclaims any representation that
the products or services described herein do not infringe upon any existing or future
intellectual property rights. Nothing herein grants the reader any license to make, use,
or sell equipment or products constructed in accordance with this document.
Finally, all rights and privileges related to any intellectual property right described
herein are vested in the patent, trademark, or service mark owner, and no other
person may exercise such rights without express permission, authority, or license
secured from the patent, trademark, or service mark owner. DreamOval reserves the
right to make changes to any information herein without further notice.
Trademarks
TABLE OF CONTENTS
Table of Contents ............................................................................................. 3
Introduction ....................................................................................................... 4
Integrating Slydepay........................................................................................ 5
INTRODUCTION
This Application Programming Interface (API) describes how to integrate your website
with Slydepay online payments. Examples and other resources for integrating can be
found under the resources tab in your merchant account.
Slydepay uses a HTTP requests and SOAP web service calls to process payments. This
works by sending the required parameters and their values to a web service through
a SSL connection followed by a redirect to a merchant order page.
This works when Slydepay mandatory parameters and their corresponding values are
sent to a web-processing page secured by an SSL connection.
INTEGRATION MODE
Integration mode basically sets your account into a demo mode to help with
development and testing of the merchants integration with API.
When ON, you can test the account with a dummy wallet (credentials below).
When ready to go LIVE! Make sure the integration mode is OFF and set the
‘Integration parameter to “0.
Email: testpaddy@slydepay.com.gh
Password: paddypaddy
5
INTEGRATING SLYDEPAY
In order to receive payments from Slydepay, you are provided with a SOAP web
service to integrate your website or application with Slydepay API servers.
Required parameters are stored as values in hidden form fields and upon click, are
POSTed from the merchant’s site to the Slydepay Merchant! Order pages.
Note: Slydepay Merchant API Web service is the most secure method of processing
payments and is available for the Slydepay Merchant API version 1.4 and above.
How it works
1. Merchant makes a web service call to the Slydepay API Service passing
the required header and method parameters.
2. The API server processes requests and validates the header and
parameters. If validation is successful, a session ID is generated and
returned to the Merchant. This ID is called a pay Token.
If there is an error in the request from the Merchant, an error code is
returned to the Merchant.
Note: Error codes are listed on page [#] in this API
3. Merchant after receiving the Pay Token can now do an HTTP redirect to
the Slydepay Merchant order page passing the Token
https://app.slydepay.com.gh/paylive/detailsnew.aspx?pay_token=
IWA19389
Step Detail
account
success/failure)
PAYLIVE URLS
PARAMETER LIST
HEADER
Parameter Description Req. Type Max Length
Specify the API version from which you
Alpha -
APIVersion are integrating your application. For this YES 10
Numeric
API version specify “1.3”
Merchant generated key from i-
Alpha-
MerchantKey Merchant account. YES 32
Numeric
Alpha-
MerchantEmail Merchant Slydepay login email YES 128
Numeric
Specify the type of service the payment
is for. The list of allowed service type Alpha-
SvcType YES 128
codes are provided below. Choose the Numeric
one that suites your transactions.
Set this “1” if you are running in
integration mode. Set to “0” or omit if
UseIntMode YES Boolean 1
you are running your merchant account
on LIVE! Mode.
PROCESSPAYMENTORDER
Parameter Description Req. Type Max Length
Defined by Merchant and may be used
for auditing and reporting. This could be a Alpha-
orderId YES 128
unique number for transactions on your Numeric
site or application.
Total cost of all items minus shipping and
subTotal tax. YES Numeric 10
ORDERITEM
Parameter Description Req. Type Max Length
Defined by Merchant and may be used
for auditing and reporting. This could be a Alpha-
itemCode YES 128
unique number for items on your site or Numeric
application.
Name or short description of item being Alpha –
itemName YES 128
purchased Numeric
Specify the unit price of the item being
unitPrice YES Numeric 10
paid for
quantity Specify the quantity of the items YES Numeric 5
The sub or line total for a specific item. It is
subTotal equal to the unit price times the quantity YES Numeric 10
of the specific item being purchased
CONFIRMTRANSACTION
Parameter Description Req. Type Max Length
The session id or pay token returned by Alpha-
payToken YES 36
the ProcessPaymentOrder method. Numeric
The unique id passed to the merchant
Alpha -
transactionId redirect url on completion of payment. YES 36
Numeric
CANCELTRANSACTION
Parameter Description Req. Type Max Length
The session id or pay token returned by Alpha-
payToken YES 36
the ProcessPaymentOrder method. Numeric
The unique id passed to the merchant
Alpha -
transactionId redirect url on completion of payment. YES 36
Numeric
9
SERVICE TYPES
Value Description
For consumer to business transactions. This can be used as a default service
C2B
type for merchants selling to Slydepay wallet holders
RESPONSE PARAMETERS
API RESPONSES
Response parameters in this section refer to responses that are sent to the Merchant
when an API call is made for a Token.
Please note that for API calls, responses are printed on the request page. Your
application should read the response and continue processing. For those using PHP
lib curl and file, it is returned in an array after the request has been made.
Response Explanation
9 Invalid Parameter
This error means there is a Parameter with an invalid type causing it to throw an
invalid parameter response, which is 9. The exact parameter is identified by T1 which
is the amount parameters. The table below can help identify the exact parameter
that causes an error with response 9.
T4
comment2 R4
L4
T5
MerchantEmail R5
L5
T6
MerchantKey R6
L6
T7
SvcType R7
L7
T8
unitPrice R8
L8
T9
quantity R9
L9
T 10
orderItems R 10
L 10
T 11
APIVersion R 11
L 11
T 12
UseToken
R 12
(deprecated)
L 12
T 13
UseIntMode R 13
L 13
11
R = parameter required
TRANSACTION RESPONSES
Response parameters send information on the status of a transaction to the link
provided by the Merchant for responses. This set of responses is sent using a get
command to the Merchant’s page.
E.g.
https://www.merchantdomain.com/secure/merchantlink.aspx?status=0&transac_id=
12938&cust_ref=124134&pay_token=345667335678
1 Confirmation Successful