Paymentwall website uses cookies to store your browsing preferences on your device. However, cookies do not collect personal information.

For more information about how we use cookies, check our cookie policy



New Documentation Getting Started API Libraries APIs Checklists Flows Integrations Mobile SDKs Reference Smart TV SDK SpiderPipe Testing Payments
If you still have questions regarding integration, please email us at

Payment Systems API

API Description

Payment Systems API allows the merchants to retrieve the list of payment systems activated for a project in a specific country along with their names, logos and shortcodes. This can be further used for deeplinking specific payment methods on merchant's existing payment page via Paymentwall Uni widgets.


Make sure that "Evaluation Mode" is ON in your project's settings:


Here's an example of how Payment Systems API can be used for integrating deeplinked payment methods powered by Paymentwall into a merchant's existing payment page: Screenshot

API Endpoint

Request Method


Request Parameters

parameter required description
country_code yes Country code in ISO 3166-1 alpha-2 format
currency_converted no Currency code (in ISO 4217 format) to be used for converting the price point amounts from local currencies to the converted currency
include_pricepoints no 1 or 0 to include pricepoints for Mobiamo
key yes Project key
sign_version no Signature version
sign yes* Request signature. Refer to Signature Calculation. Can be made optional if "Widget Signature is Required" setting is off in My Projects > Settings

Request Sample[PROJECT_KEY]&country_code=RU&sign_version=2&sign=[SIGNATURE]

Response Sample

    "name":"Credit card",
    "name":"Qiwi Wallet",

Response Details

parameter description
id Payment system shortcode
name Payment system name
img_url URL of the payment system logo
new_window For payment methods that require opening a new window or redirecting users to a new window, this flag will be true. Example: WebMoney requires users to be redirected to a new window. You can redirect users via $widget->getUrl() method.

Code Sample

$params = array(
    'key' => 'YOUR_PUBLIC_KEY',
    'country_code' => 'RU',
    'sign_version' => 2

Paymentwall_Config::getInstance()->set(array('private_key' => 'YOUR_PRIVATE_KEY'));
$params['sign'] = (new Paymentwall_Signature_Widget())->calculate(

$url = '' . http_build_query($params);
$payment_systems = json_decode(file_get_contents($url));
This page needs JavaScript
Your browser is
not supported anymore.
Please update to the more recent one.
This page needs JavaScript
This page needs JavaScript.
Please enable it in your browser settings and try again.
We use cookies on this website to make your browsing experience better. By using the Paymentwall website you agree to our Cookie Policy.