2-Click Payments

Paymentwall’s 2-click payment widget allows you to quickly charge your customers’ credit card simply and easily. The small widget can be integrated as a layer in a flash game or as a stand alone widget anywhere within your product. You can adjust the pricing in each country or region using our easy to use administrative tools. If your users are from regions of the world where Credit Cards are not as popular, our Widget will automatically show alternative payment options as the default. We offer further alternative payment methods such as PayPal, Mobile Payments, e-wallets, prepaid cards, bank transfers, direct debit and terminals/kiosks allowing every user the opportunity to pay in a way that they are comfortable and familiar with in their native language.

  • Ultra compact (370x450 px)
  • Easy to use UI
  • Currency selection
  • 20+ local languages
  • Customizable design and color scheme
  • Supports Flash applications
  • Optional price point selection
  • Flexible pricing supported
  • Credit card number can be stored for faster subsequent use by the users
  • PCI compliant secure widget

Screen Shot Gallery:

Default view for countries with available credit card payments

Screen shotNext »

Integration Documentation V1.0

April 17, 2011

Widget URL: https://wallapi.com/api/ccwall
Request method: GET

Request Parameters


ParameterDescriptionRequired
keyApplication keyYes
uidUser idYes
amountAmount of the purchase, i.e. 10.00No
currencyCodeCurrency of the purchase, i.e. USD, EURNo
vcVirtual currency name, i.e. GoldNo
vc_amountVirtual currency amount, i.e. 100No
tsTime when request was initiated, represented as Unix timestamp - seconds since the Unix epoch (January 1 1970 00:00:00 GMT). If it’s older then 60 minutes, user sees an error message. Recommended for preventing widget from being shared.No
sign_versionVersion of signature. sign_version=2 needs to be usedYes
signRequest signature. All parameters in request need to be signed. Refer to signature calculation section belowYes

Additionally, you can pass custom parameters to the widget and they can be returned in the pingback.

Signature calculation & building widget URL

Please note, that application key and secret need to be replaced with your own application specific values.

<?php
function generateSignature($params, $secret) {
// work with sorted data
ksort($params);

// generate the base string
$baseString = '';
foreach($params as $key => $value) {
$baseString .= $key . '=' . $value;
}
$baseString .= $secret;

return md5($baseString);
$secret = 'bffbccd175e957267f3e17f42c1dc6ed';

$params = array(
'key' => '6ed109b8dcc6ab30863c14c5e64e1758',
'uid' => '218069',
'amount' => '10.00',
'currencyCode' => 'USD',
'vc' => 'Gold',
'vc_amount' => '100',
'ts' => '1325368800', //assuming this is returned by time()
'sign_version' => '2',
);

$params['sign'] = generateSignature($params, $secret);

$url = 'https://wallapi.com/api/ccwall';

echo $url . '?' . http_build_query($params);

echo $params['sign'];

Given example will output


https://wallapi.com/api/ccwall?key=6ed109b8dcc6ab30863c14c5e64e1758&uid=218069
&amount=10.00&currencyCode=USD&vc=Gold&vc_amount=100&ts=1325368800&sign_version=2
&sign=e4eb7451d15c832cba2aa9dc34477653