This Web Site Integration Guide provides detailed information and
instructions for using the eDigiCash gateway to accept payments on
your web site.
You will learn how to:
Before starting the web site integration, you should determine which
payment processing options are best suited for your environment.
There are basically two methods to initiate a payment:
Online forms: your web site includes at least an order form,
a PAYMENT page for approved orders, and a NOPAYMENT page for declined or
cancelled orders. Typically, the order form contains a Pay button that
redirects the buyer to the eDigiCash server.
Your site sends the final transaction total to the
eDigiCash service over a secure TLS/SSL connection.
The buyer can then select one of the payment methods that have been activated.
The eDigiCash server processes the payment request.
If the transaction was successful, and if so configured in the Merchant
Administration pages, an Instant Payment Notification (IPN) is posted to
the merchant site.
Finally, the buyer is redirected to the PAYMENT or NOPAYMENT pages on
your site. This allows you to perform any post-payment processing on your
web site.
Payment Links: Payment Links placed in a web site or in an email
message allow buyers to trigger payments without interacting with your
site. At the end of the payment process, the buyer is not redirected
to your site. This method can be seen as an offline payment method.
This feature is very useful for bulk billing by email (subscriptions,
recurring payment notifications, etc.)
When online forms are used, you can select between Native Mode
(recommended) and e-gold Emulation Mode. If you are already accepting
e-gold payment through the Shopping Cart Interface,
e-gold Emulation Mode can be used to switch to eDigiCash
without having to rewrite the interface.
Please note that a few minor restrictions apply (see notes below).
The Native Mode is a more powerful interface and should be used
as the preferred method to communicate with the eDigiCash
gateway.
Whichever method is used, you can activate Email Notification,
Instant Payment Notification (IPN), or both, to be notified when a payment
was successful.
Email Notification: This option requires only an email address. When a
payment was successful, an email is automatically sent to you to confirm
the payment.
Instant Payment Notification (IPN): To use this option, you must
implement a script on your own web site. When a payment was successful, the
eDigiCash system immediately posts a notification -
technically a HTML POST request - to your site. Your
script can do whatever is required: update a database, write an invoice, etc.
Although more complicated, this method gives you more flexibility than manual
email verification.
Note(s)
Due to the very nature of HTML, PAYMENT postbacks can be easily faked. You
should never rely on them to make sure that a payment was successful. The only safe
method to verify a payment is to activate IPN and/or email notification.
Since only payment data is collected by the eDigiCash service,
billing and shipping information must be collected on your web site. This may
change in the future.
Requirements
First, you need accounts to receive your payments. For example, if you want to accept
e-gold or Pecunix payments, you must have e-gold and Pecunix accounts. This is the nice
thing with eDigiCash: all payments are made directly to your
accounts.
eDigiCash only offers the technical platform and infrastructure.
Implementation
With eDigiCash, you implements only one interface to
get access to all supported payment options. Go to the
How It Works page for more
information.
In order to get started quickly, eDigiCash provides a Code
Generation page for creating the necessary Online forms or Payment Links.
The Code Generation page is a form where you can enter the details of your payment.
eDigiCash generates the code that can be copied into the page
where you want the button to appear.
Suspicious transactions
When validating a transaction, the eDigiCash system uses all available options to
verify that the transaction really comes from the selected payment system. This includes:
Verification of the requester's IP address,
Verification of the PGP signature and MD5/SHA1 digests when available,
Verification of the returned values to make sure that they match the request's fields.
However, there are unusual situations where the eDigiCash system
cannot determine whether a payment feedback really comes from the selected payment server.
Assume that you have specified the wrong password or MD5/SHA1 digest in the Administration Tool.
eDigiCash attempts to verify the data supposedly coming from the payment
server and detects a mismatch. In such a situation, the eDigiCash
system flags the transaction as suspicious and automatically sends a warning email
to you (regardless of the Email Notification setting). You will have to manually check the
transaction against the selected payment system (for example e-gold) to verify that the
transaction is valid.
For more information about Web Site Integration, please go to the
Support page and use the "Support Request"
form.
