PayGol - Micropayments implementation

Need help? Click here

Follow us:

My Account Create service How it works Affiliate Support Blog Contact

Implementation for Web apps

Why PayGol?
How to use PayGol for Web apps
Parameters description
How to test your service
IPN
IPN Parameters description

Why PayGol?

How convenient and easy is your payment model from the user's point of view? Is a credit card number or bank account information prerequisites for buying a service in your payment model? Do users have doubts about security when they provide their credit card number or bank account information? Is it possible to have a different, yet more practical payment model which does not require providing any data? Luckily the answer is Yes!. PayGol provides you a payment model using SMS messages. When a user buys a service, he/she makes the payment by sending only SMS messages and she does not provide any personal data. PayGol technology is practical, secure, easy to integrate and convenient for both: for developers who integrate a payment model and for end users who buy a service.

The code below is ready to use. Just copy the piece of code into your web page and you will be ready to charge with micropayments. You choose between Pop-up and Post method.
You can test your service by clicking on the image or on the button you have chosen, both contain your service which is already running.

PopUp code
Post code

<script src="http://www.paygol.com/micropayment/js/paygol.js" type="text/javascript"></script>


<form name="pg_frm">
<input type="hidden" name="pg_serviceid" value="123">
<input type="hidden" name="pg_currency" value="EUR">
<input type="hidden" name="pg_name" value="DEMO">
<input type="hidden" name="pg_custom" value="">
<input type="hidden" name="pg_price" value="1">
<input type="hidden" name="pg_return_url" value="http://www.paygol.com/micropayment/implementation">
<input type="hidden" name="pg_cancel_url" value="">
<input type="image" name="pg_button" class="paygol" src="http://www.paygol.com/micropayment/img/buttons/150/black_en_pbm.png" border="0" alt="Make payments with PayGol: the easiest way!" title="Make payments with PayGol: the easiest way!" onClick="pg_reDirect(this.form)">
</form>

<form name="pg_frm" method="post" action="http://www.paygol.com/micropayment/paynow" >
<input type="hidden" name="pg_serviceid" value="123">
<input type="hidden" name="pg_currency" value="EUR">
<input type="hidden" name="pg_name" value="DEMO">
<input type="hidden" name="pg_custom" value="">
<input type="hidden" name="pg_price" value="1">
<input type="hidden" name="pg_return_url" value="http://www.paygol.com/micropayment/implementation">
<input type="hidden" name="pg_cancel_url" value="">
<input type="image" name="pg_button" src="http://www.paygol.com/micropayment/img/buttons/150/black_en_pbm.png" border="0" alt="Make payments with PayGol: the easiest way!" title="Make payments with PayGol: the easiest way!" >
</form>

See demo using Pop-up

See demo using Post

Parameter	Description
pg_serviceid	This is the unique ID of your service.
pg_currency	Type of currency specified in alphabetic code ISO 4217 you want to use (eg: EUR, USD, GBP, MXN, etc.). See the full list of the currency codes.
pg_price	The price of your service, you can simply change it. If your clients select other country, currency will be automatically converted.
pg_name	Name of your service which will be shown on the payment screen.
pg_custom	Custom field, can be used to track inventory, e.g. product id.
pg_return_url	This URL is optional, once your customers has paid he will be redirected to this URL (eg: http://www.mysite.com/thanks), otherwise the payment screen will just fade out.
pg_cancel_url	An internet URL where your customer will be returned after cancelling payment.
pg_notify_url	Only used with IPN (Instant Payment Notification). An internet URL where IPN form posts will be sent.
pg_button	This is the button you have chosen, you can add your own button or select one from our collection.

After your code is ready it's important to test your service by clicking on the image or on the button you have chosen, both contain your service which is already running.

Go to your control panel and click on My Services (fig. A)

On your Services settings change from Enabled to Testing mode. (fig. B)

Once ready Click on the implementation icon (fig. C)

You now will be redirected to your test page

Choose demo using Pop-up or demo using Post

Click on the red arrow to enter test mode (fig. D)

Payment screen will display now in test mode (Blue tube indicates test mode)

Notice the name of the payment screen is the one you entered when you created the service.

We used Test Service as our service name.

Test Service £1.00, instruction states: Send GOL 813725 to phone number 88080 (fig. E)

You are supposed to send this and receive a pin code , you don't need to do this in test mode.

Your test pin code will be 123456, you must enter this pin on the field and press OK (fig. F)

Wait for valid confirmation, after this you will be redirected to your designated Success URL.

What is IPN?

Instant Payment Notification (IPN) is a message service that notifies you of events related to PayGol transactions. You can use it to automate back-office and administrative functions, such as fulfilling orders, inserting points or coins, upgrading membership, tracking customers, and providing status and other information related to a transaction.

Information about the payment

PayGol generates an IPN message when your customer clicks a button, such as a buy, download or donation button, and completes the transaction on PayGol. You can use this notification to kick-off order fulfillment, enable digital media downloads, store information in a customer relationship management (CRM) or accounting system, and so on.

How to receive the IPN information in my web page?

PayGol provides samples of Instant Payment Notification (IPN) code for popular development environments. Use working sample code to speed up your PayGol integrations.

This PHP sample code will just send you an e-mail everytime when a payment has been notified. Of course you can add your own funcionalities instead of just sending an email.

<?php

// check that the request comes from PayGol server
/*
if(!in_array($_SERVER['REMOTE_ADDR'],
  array('109.70.3.48', '109.70.3.146', '109.70.3.58'))) {
  header("HTTP/1.0 403 Forbidden");
  die("Error: Unknown IP");
}
*/

// get the variables from PayGol system
$message_id = $_GET['message_id'];
$service_id = $_GET['service_id'];
$shortcode = $_GET['shortcode'];
$keyword = $_GET['keyword'];
$message = $_GET['message'];
$sender = $_GET['sender'];
$operator = $_GET['operator'];
$country = $_GET['country'];
$custom = $_GET['custom'];
$points = $_GET['points'];
$price = $_GET['price'];
$currency = $_GET['currency'];

// Here you can do whatever you want with the variables, for instance inserting or updating data into your Database

?>

Parameter	Description
message_id	The ID of the incoming message.
service_id	The ID of the service
shortcode	The shortcode of the message was sent to.
keyword	The keyword of the service.
message	The generated code which the end-user (your customer) have sent. Actually, this is the PIN end-user will receive and will have to enter in the payment screen, for example PIN:123456
sender	Your customer phone number in international format.
operator	ID of the mobile operator of your customer.
country	The country code of your customer specified in ISO 3166. (E.g.: EN, ES, FR, DE, etc.)
custom	The custom field specified in your original form.
points	Points or coins that you have defined in your Multi-price service
price	The price of the product in the transaction.
currency	The currency code of the transaction (E.g.: EUR, USD, GBP, MXN, etc.)

See who is using PayGol services, you can use our mobile payments services in any type of web site.

In most countries PayGol cover all carriers with different prices you can charge your customers. You can select the end-user price that works best for your product or service.

For Web applications

For Android applications

Sending SMS messages

© 2013 PayGol.com all rights reserved. | Terms of Service | Payouts by