Payment Integration Guide

Learn how to use HTML forms so that you can integrate Weezzo into your website or e-commerce application in order to receive payments. With Weezzo you add buttons to your webpages for different types of payments. Shoppers click the payment buttons to pay for their purchases.

Table of contents:

§1. General Information
§2. Creating a Payment Link
- §2.1. Various Link Samples
- §2.2. Placing Payment Links and "Pay by Weezzo" Graphics
- §2.3. Checkout Page Experience and Interface
- §2.4. Setting URL for Auto-Return to Your Site After Purchase
§3. Handling IPN Messages
- §3.1. IPN Handler Setup
- §3.2. Writing Handler Code
- §3.3. Testing Your IPN Handler
§4. Using API Functions
§5. Managing Payments via Web Interface
§6. Final Testing of Payment Processing
§7. Code Samples in Various Programming Languages

§1. General Information

Weezzo electronic payment solution provides extensive processing features for merchants selling digital content, services and physical goods (buyer will be asked to provide a shipping address). It can also be used for donations. Your clients can pay with their Weezzo wallet balance as well as by additional payment methods activated for your business/wallet.

Note: Merchant functionality is only available to a verified corporate account owners. Read more in the General Reference Guide for Merchants.

Weezzo offers you the following beneficial features:

Receive payments in any of the 21 supported world currencies.
In addition to prices you can set shipping and handling fees as well as taxes. This information is displayed on the checkout pages.
Charge payments for digital content, services and physical goods (buyer will be asked to provide a shipping address) and even for donations.
Combine several items within one payment (shopping cart contents) so that the buyer pays only once for several goods and/or services.
A transaction fee can be paid either by the seller (you) or the buyer (your client), depending on your settings. If you pay the fee, regardless of the chosen payment method, the client will only be charged a specified price and you will receive the remaining amount after all commissions (amount minus fees). If the buyer pays the fee, the exact amount you specified will be credited to your Weezzo account and the client pays a little more (amount plus fees).
Your clients can use any of the payment methods activated for your business/wallet.

The image below shows an average buying process in an online store. Depending on your type of business, the process may look slightly different.

Figure 1. Scheme of the buying process.

In order to accept payments, your website must feature a special payment link (or graphical button). Clients using a payment link are redirected from your website to a checkout page where they complete their payment. With the Auto Return feature enabled, your customers are then quickly returned to your site.

Merchants receive an e-mail notification of each payment received from customers. Weezzo also uses an IPN notification service to transfer all the necessary technical details to your website/back office application.

All payments are instantly displayed on the main page of your Weezzo account. You can split the cash flows of different groups of goods/websites into different wallets, allowing you to simplify your accounting and perform a quick search and navigation. See Managing Payments via Web Interface.

Figure 2. Transactions list.

Almost any task carried out using the web interface can also be performed via Weezzo API.

We will explain these steps and features in detail.

§2. Creating a Payment Link

In order to let your customers pay for a product or service, you need to create a special URL link to be placed on your website. Use Button Generator or manually create a URL using variables described in the Payment Links Variable Reference.

The easiest way is to use Button Generator. The resulting automatic code is no different from one created manually.

Note: To learn more about general payment links and button usage, see Payment Links section of the Comprehensive Manual.

§2.1. Various Link Samples

Here are some examples of how one can create and use different types of payment buttons. You can combine variables to create your own custom payment forms:

Basic Payment
Basic Payment with Invoice
Several Items
Item Quantity
Shipping
Taxes and Handling
Payment Argument
Custom Payment Arguments
Custom Price
Commission on Buyer
Custom Payment Options
Direct Payment Processing

A detailed description of payment button variables can be found in Payment Links Variable Reference, section Payment Links of Comprehensive Manual.

Basic Payment

The Basic Payment form is the simplest way to sell any type of digital goods or receive payent for a service. As an example, we will use it to sell an Weezzo poster.
The form contains only the minimum required variables such as ok_item_1_name, ok_item_1_price, ok_currency.

<form  method="post" action="https://checkout.weezzo.com/">
   <input type="hidden" name="WZreceiver" value="WZ"/>
   <input type="hidden" name="WZitem_1_name" value="Poster"/>
   <input type="hidden" name="WZitem_1_price" value="100"/>
   <input type="hidden" name="WZcurrency" value="USD"/>
   <input type="image" name="submit" alt="Payment" src="https://download.weezzo.com/images_buttons/en/buy/b07g56x35en.png" />
</form>

<a href="https://checkout.weezzo.com/?WZreceiver=WZ&WZitem_1_name=Poster&WZitem_1_price=100&WZcurrency=USD"></a>