merchant Integration Getting Started Guide v 2.0 .pdf

File information


Original filename: merchant Integration Getting Started Guide v 2.0.pdf
Author: Moumen Abdeen

This PDF 1.5 document has been generated by Microsoft® Office Word 2007, and has been sent on pdf-archive.com on 23/10/2016 at 07:22, from IP address 93.35.x.x. The current document download page has been viewed 768 times.
File size: 1.5 MB (47 pages).
Privacy: public file


Download original PDF file


merchant Integration Getting Started Guide v 2.0.pdf (PDF, 1.5 MB)


Share on social networks



Link to this file download page



Document preview


CASHU Merchant
Integration
(Prepaid & Checkout with CASHU)
Getting Started Guide
Document Version: 2.0
August 14th, 2016

Copyright Statement
All rights reserved. No part of this document may be reproduced in any form or by any means or used to
make any derivative such as translation, transformation, or adaptation without the prior written permission
from CASHU Corporation.

Trademark
Copyright ©2015 CASHU Corporation. Contents are subject to change without prior notice. CASHU is a
registered trademark of CASHU Corporation.

Contact Us
Jordan+962 6 5826097 ext. 3619
integration@cashu.com
www.cashu.com

Copyright© CASHU 2015

2

CASHU

Getting Started Guide

Contents
1.

CASHU ................................................................................................................................................... 5

2.

About this Document ............................................................................................................................ 6
2.1

Intended Audience ........................................................................................................................ 6

2.2

Document Conventions ................................................................................................................ 6

3.

Glossary ................................................................................................................................................. 8

4.

CASHU Prepaid Payment Transaction Workflow .................................................................................. 9

5.

CASHU Prepaid Integration Steps ....................................................................................................... 10

Appendix 1 – URLs .................................................................................................................................... 39
Appendix 2 – (Important) Security Measures......................................................................................... 40
Appendix 3 – Checkout with CASHU (CWC) ......................................................................................... 41
Appendix 4 – Checkout with CASHU on Sandbox Environment ................................................................. 42

Copyright© CASHU 2015

3

CASHU

Getting Started Guide

Table of Figures:
Figure 1: Current Status – Test It ................................................................................................................ 10
Figure 2: Service Setup – First Step ............................................................................................................ 11
Figure 3: Create sub Checkout .................................................................................................................... 11
Figure 4: Service Setup – Second Step ........................................................................................................ 12
Figure 5: Service Setup – Third Step ........................................................................................................... 14
Figure 6: Service Setup – Fourth Step......................................................................................................... 15
Figure 7: Service Setup Complete ............................................................................................................... 15
Figure 8: Security Settings .......................................................................................................................... 16
Figure 9: CASHU Prepaid Credentials ......................................................................................................... 33
Figure 10: Prepaid Testing Settings ............................................................................................................ 34
Figure 11: "Go to Live" Button .................................................................................................................... 35
Figure 12:Basic information ........................................................................................................................ 36
Figure 13: Settlement Account Details ....................................................................................................... 37
Figure 14: Contact Information Details ...................................................................................................... 38
Figure 15: CWC Option – Merchant Area ................................................................................................... 42
Figure 16: Activating Checkout with CASHU............................................................................................... 43
Figure 17: Checkout with CASHU Payment page - 1................................................................................... 44
Figure 18: Checkout with CASHU Payment page - 2................................................................................... 44
Figure 19: Checkout with CASHU Payment Page - Mobile Number Field .................................................. 45
Figure 20: Checkout with CASHU Payment Page –Verification Code ......................................................... 45
Figure 21: Checkout with CASHU Payment Page – CC Information ........................................................... 46
Figure 22:Merchant Area - Credit Card Test Information........................................................................... 46

Copyright© CASHU 2015

4

CASHU

Getting Started Guide

1. CASHU
CASHU is an electronic payment solution developed specifically for the Arab speaking
world with the aim to help any business become a successful online Merchant in the
region. It is available for almost everyone selling products or services without
restrictions, setup fees or bureaucracy.
The CASHU Merchant Service offers you a way to accept payments through the
CASHU Payment Gateway.

Copyright© CASHU 2015

5

CASHU

Getting Started Guide

2. About this Document
This document provides step-by-step instructions to get started with CASHU Integration.
This document tackles the integration of CASHU Products. It describes the features,
services, parameters and the technical environment required by merchants and
provided by CASHU to achieve a successful implementation.
CASHU supports the setup of payments in both test and production environments by
providing merchants with two accounts; the first one is designated for testing (Sandbox)
and the other one is or livetransactions.

2.1 Intended Audience
This document is intended for software developers with knowledge and authority to
integrate third party payment solutions on a merchant's e-commerce platform. Since
CASHU Payment Gateway does not require any software installation, the required skills
are determined by technologies used on the Merchant’s website and the necessity to
integrate the Payment Gateway with back-end systems.
The integration details in this document are applied to all Merchants regardless of the
programming language.

2.2 Document Conventions
The following typographic conventions are used in this document:
Convention

Description

Bold

Used for headings, names of pages and menus, elements supplied by
the system, names of commands and illustrated steps.

Underlined

Text in this typeface represents important resources, names of used
programs and indicates terms that are defined in the text or appear in a
glossary

Bold and
Underlined

Used for sub heading

[ ]

Contains Regular Expression Definitions

Copyright© CASHU 2015

6

CASHU

Getting Started Guide

The following types of notes are used in this document:
Type

Note

Copyright© CASHU 2015

Description

NOTE!
Notes with a blue background contain important
information for you to keep in mind as well as helpful tips.

7

CASHU

Getting Started Guide

3. Glossary
Term

Definition

Merchant ID

A unique ID for each Merchant. This ID will be chosen and created
during theprocess and will be used for login purposes as well as
identifying Merchants' requests in the integration process. It is
preferred to use a descriptive and an easy-to-remember ID.

Encryption Keyword

Any suitable Keyword selected and defined by the Merchant, which
will be used to verify the payment transaction request, by using its
value in the Token, verificationString and cashuToken calculations.
An encrypted parameter sent by the Merchant in every payment
request and used to verify that the transaction is owned by this
particular Merchant, it also sent after any successful payment
transaction by CASHU to Return URL and Notification URL.

Token

The Merchant should recalculate the Original parameters and match
them with this parameter to verify that the correct amount was
collected successfully without any manipulation.
The Token calculation is explained in a later section.

verificationString

A parameter sent after any successful payment transaction by
CASHU to the ReturnURL. The Merchant should recalculate the
received parameters and match them with this parameter to verify
that the transaction response was received from CASHU.
The verificationStringcalculationis explained in a later section.

ReturnURL

cashuToken

Refers to the URL where the customer will be redirected after a
successful payment transaction and its mandatory
One
of
the
parameters
sent
by
CASHU
to
the
Merchant'sNotificationURL, where the Merchant should calculate the
received parameters and matchthem with this parameter to verify
that the transaction response was received from CASHU.
The cashuTokencalculationis explained in a later section.

NotificationURL

Refers to the URL where the Merchant will be receiving the XML
Notification sent by CASHU immediately after a successful payment
transaction. Its optional but recommended

Merchant Display
Name

The name that will appear to the consumers on the payment page,
which refers to the Merchant's trade name.
A parameter the Merchant should use when referring toSub
Merchant Checkout name that currently is under integration.

Service Name

Copyright© CASHU 2015

CASHU allow the merchant to create multiple Merchant Checkout
Pages under the same Merchant Account. In case a Merchant has
more than one Merchant Checkout Page.

8

CASHU

Getting Started Guide

4. CASHU Prepaid Payment Transaction Workflow
A payment transaction between the merchant and the customeron CASHU takes the
following steps:
1. The customer visits the merchant website and selects to purchase a Product/Service
2. The customer follows the merchants purchasing flow and proceeds to the payment
section (checkout page) of the merchant website.
3. The customer selects to pay by CASHU.
4. The customer is redirected to CASHU Payment page where the description of the
Product/Service and the total price are presented.
5. The customer authorizes and completes the payment (clicks pay).
6. CASHU validates the payment. If the transaction is approved, it is executed in realtime (directly) and recorded in CASHU's system.
7. In case of any error, CASHU will either display a relevant error message on CASHU
payment page or if the merchant implements the Sorry URL; CASHU sends an error
code to the merchant Sorry URL (it should be predefined)then he will be responsible
for showing the relevant error description to the customer.
8. After the execution of a transaction, the customer is redirected to a predefined
section of the Merchant’s website Return URL and CASHU will send notification to
the merchant’s Notification URL (if implemented).

Copyright© CASHU 2015

9


Related documents


merchant integration getting started guide v 2 0
merchant services
matta sota registration 280317 1 1
8
table of content merchant setup guide
technical reference and integration guide

Link to this page


Permanent link

Use the permanent link to the download page to share your document on Facebook, Twitter, LinkedIn, or directly with a contact by e-Mail, Messenger, Whatsapp, Line..

Short link

Use the short link to share your document on Twitter or by text message (SMS)

HTML Code

Copy the following HTML code to share your document on a Website or Blog

QR Code

QR Code link to PDF file merchant Integration Getting Started Guide v 2.0.pdf