Быстрый старт

Рис.: PHP

1 Подключаем SDK

1. Если не делали этого ранее, загружаем, устанавливаем и настраиваем менеджер зависимостей Composer (https://getcomposer.org/).
2. В командной строке операционной системы переходим в каталог с исходным кодом веб-сервиса и выполняем команду composer require ecommpay/paymentpage-sdk.
3. Подключаем скрипт autoload.php в исходном коде веб-сервиса.

// Подключение библиотек
require` __DIR__.'../../vendor.autoload.php';

2 Обеспечиваем подписывание данных

Когда для всех необходимых параметров определены их значения (и только в таком случае), можно собирать эти данные в серверной части веб-сервиса и формировать подпись и URL для вызова платёжной формы. Как это делать, можно разобрать на примере.

// Подписывание данных и формирование ссылки

// создание объекта класса Payment и указание идентификаторов проекта и платежа
$payment = new ecommpay Payment('57123', 'payment_443');

// указание других обязательных параметров
$payment->setPaymentAmount(1815)->setPaymentCurrency('EUR'); // сумма и валюта платежа
$payment->setCustomerId('customer_112'); // идентификатор пользователя

// создание объекта класса Gate и указание секретного ключа
$gate = new ecommpay\Gate('<secret_key>');

// формирование ссылки для вызова платёжной формы
$url = $gate->getPurchasePaymentPageUrl($payment);

3 Настраиваем приём оповещений

Чтобы оперативно узнавать о результатах платежей и получать другую значимую информацию, следует настроить приём и обработку программных оповещений от платёжной платформы. Это делается в три шага:

1. Определяем и задаём в платёжной платформе адрес для приёма веб-сервисом оповещений по проекту (сначала можно задать один общий адрес, а после — несколько, под разные события). Для этого открываем в интерфейсе Dashboard раздел Проекты и используем инструменты на вкладке Оповещения.
2. Настраиваем проверку целостности и разбор оповещений, поступающих на указанный URL, с использованием SDK.
3. Настраиваем отправку синхронных HTTP-ответов о приёме оповещений: 200 ОК если подпись корректна и 400 Bad Request если подпись некорректна.

// Работа с оповещениями

// создание объекта класса Gate и указание секретного ключа
$gate = new ecommpay\Gate('<secret_key>');

// создание объекта класса Callback и указание JSON-строки с данными
// из оповещения ($data), с проверкой целостности данных
$callback = $gate->handleCallback($data);

// использование методов для работы с оповещениями
Callback::getPaymentId();        // получение идентификатора платежа
Callback::getPaymentStatus();    // получение статуса платежа
Callback::getPayment();          // получение всей информации из оповещения

Описания используемых статусов платежей можно найти в отдельном разделе, а описание оповещений и работы с ними — в отдельной статье. При этом важно помнить, что в случаях, когда пользователь не подтверждает оплату в платёжной форме, платёж не регистрируется (и статуса по нему тоже нет).

Извлечённую из оповещений информацию можно использовать для оперативного обновления статусов заказов в веб-сервисе, информирования пользователей и других целей — в соответствии с моделью работы вашего веб-сервиса.

Рис.: Python

1 Подключаем SDK

1. Если не делали этого ранее, загружаем, устанавливаем и настраиваем систему управления пакетами pip (https://pip.pypa.io/en/stable/).
2. В командной строке операционной системы переходим в каталог с исходным кодом веб-сервиса и выполняем команду pip install ECommPay.PaymentPage.SDK.
3. Подключаем библиотеки из SDK в исходном коде веб-сервиса.

# Подключение библиотек
from payment_page_sdk.gate import Gate
from payment_page_sdk.payment import Payment

2 Обеспечиваем подписывание данных

Когда для всех необходимых параметров определены их значения (и только в таком случае), можно собирать эти данные в серверной части веб-сервиса и формировать подпись и URL для вызова платёжной формы. Как это делать, можно разобрать на примере.

# Подписывание данных и формирование ссылки

# создание объекта класса Payment и указание идентификаторов проекта и платежа
payment = Payment('57123', 'payment_443')

# указание других обязательных параметров
payment.payment_amount = 1815 # сумма платежа
payment.payment_currency = 'EUR' # валюта платежа
payment.customer_id = 'customer_112' # идентификатор пользователя

# создание объекта класса Gate и указание секретного ключа
gate = Gate('<secret_key>')

# формированием ссылки для вызова платёжной формы
payment_url = gate.get_purchase_payment_page_url(payment)

3 Настраиваем приём оповещений

Чтобы оперативно узнавать о результатах платежей и получать другую значимую информацию, следует настроить приём и обработку программных оповещений от платёжной платформы. Это делается в три шага:

1. Определяем и задаём в платёжной платформе адрес для приёма веб-сервисом оповещений по проекту (сначала можно задать один общий адрес, а после — несколько, под разные события). Для этого открываем в интерфейсе Dashboard раздел Проекты и используем инструменты на вкладке Оповещения.
2. Настраиваем проверку целостности и разбор оповещений, поступающих на указанный URL, с использованием SDK.
3. Настраиваем отправку синхронных HTTP-ответов о приёме оповещений: 200 ОК если подпись корректна и 400 Bad Request если подпись некорректна.

# Работа с оповещениями

# создание объекта класса Gate и указание секретного ключа
gate = Gate('<secret_key>')

# создание объекта класса Callback и указание JSON-строки с данными
# из оповещения (data), с проверкой целостности данных
callback = gate.handle_callback(data)

# использование методов для работы с оповещениями
callback.get_payment_id()        # получение идентификатора платежа
callback.get_payment_status()    # получение статуса платежа
callback.get_payment()           # получение всей информации из оповещения

Описания используемых статусов платежей можно найти в отдельном разделе, а описание оповещений и работы с ними — в отдельной статье. При этом важно помнить, что в случаях, когда пользователь не подтверждает оплату в платёжной форме, платёж не регистрируется (и статуса по нему тоже нет).

Извлечённую из оповещений информацию можно использовать для оперативного обновления статусов заказов в веб-сервисе, информирования пользователей и других целей — в соответствии с моделью работы вашего веб-сервиса.

Рис.: JavaScript

1 Подключаем SDK

1. Если не делали этого ранее, загружаем, устанавливаем и настраиваем систему управления пакетами: Yarn (https://yarnpkg.com/en/docs/getting-started) или npm (https://www.npmjs.com/package/ecommpay).
2. В командной строке операционной системы переходим в каталог с исходным кодом веб-сервиса и выполняем одну из команд: yarn add ecommpay или npm install ecommpay.
3. Подключаем модули в исходном коде веб-сервиса.

   const { Payment } = require('ecommpay');
   const { Callback } = require('ecommpay');
   

2 Обеспечиваем подписывание данных

Когда для всех необходимых параметров определены их значения (и только в таком случае), можно собирать эти данные в серверной части веб-сервиса и формировать подпись и URL для вызова платёжной формы. Как это делать, можно разобрать на примере.

// Подписывание данных и формирование ссылки

// создание объекта класса Payment и указание идентификатора проекта и секретного ключа
const payment = new Payment('57123', 'payment_443');

// указание идентификатора платежа
payment.paymentId = 'payment_443;

// указание других обязательных параметров
payment.paymentAmount = 1815 // сумма платежа
payment.paymentCurrency = 'EUR' // валюта платежа
payment.customerId = 'customer_112' // идентификатор пользователя

// получение ссылки для вызова платёжной формы
const url = payment.getUrl();

3 Настраиваем приём оповещений

Чтобы оперативно узнавать о результатах платежей и получать другую значимую информацию, следует настроить приём и обработку программных оповещений от платёжной платформы. Это делается в три шага:

1. Определяем и задаём в платёжной платформе адрес для приёма веб-сервисом оповещений по проекту (сначала можно задать один общий адрес, а после — несколько, под разные события). Для этого открываем в интерфейсе Dashboard раздел Проекты и используем инструменты на вкладке Оповещения.
2. Настраиваем проверку целостности и разбор оповещений, поступающих на указанный URL, с использованием SDK.
3. Настраиваем отправку синхронных HTTP-ответов о приёме оповещений: 200 ОК если подпись корректна и 400 Bad Request если подпись некорректна.

// Работа с оповещениями

// создние объекта класса Callback и указание секретного ключа
const callback = new Callback(<secret_key>, req.body);

// использование методов для работы с оповещениями
app.post('/payment/callback', function(req, res) {
  const callback = new Callback(<secret_key>, req.body);
  if (callback.isPaymentSuccess()) {
    const paymentCont = callback.payment();    // получение всей информации о платеже
    const paymentId = callback.getPaymentId(); // получение идентификатора платежа

    // Здесь размещается исходный код для обработки оповещения проведённого платежа
  }
});

Описания используемых статусов платежей можно найти в отдельном разделе, а описание оповещений и работы с ними — в отдельной статье. При этом важно помнить, что в случаях, когда пользователь не подтверждает оплату в платёжной форме, платёж не регистрируется (и статуса по нему тоже нет).

Извлечённую из оповещений информацию можно использовать для оперативного обновления статусов заказов в веб-сервисе, информирования пользователей и других целей — в соответствии с моделью работы вашего веб-сервиса.

Рис.: PHP

1 Обеспечиваем подписывание данных

// Кодирование алгоритма
class Signer
{
    const ALGORITHM = 'sha512';
    const ITEMS_DELIMITER = ';';
 
 
    /**
     * Generate signature
     *
     * @param array $params
     * @param string $secretKey
     * @param array $ignoreParamKeys
     * @param bool $doNotHash
     *
     * @return string
     */
    public static function sign(array $params, string $secretKey, array $ignoreParamKeys = [], bool $doNotHash = false): string
    {
        $paramsPrepared = self::getParamsToSign($params, $ignoreParamKeys, 1, '');
        $stringToSign = implode(self::ITEMS_DELIMITER, $paramsPrepared);
 
        return $doNotHash
            ? $stringToSign
            : base64_encode(hash_hmac(self::ALGORITHM, $stringToSign, $secretKey, true));
    }
 
    /**
     * Get parameters to sign
     *
     * @param array $params
     * @param array $ignoreParamKeys
     * @param int $currentLevel
     * @param string $prefix
     *
     * @return array
     */
    private static function getParamsToSign(
        array  $params,
        array  $ignoreParamKeys = [],
        int    $currentLevel = 1,
        string $prefix = ''
    ): array
    {
        $paramsToSign = [];
 
        foreach ($params as $key => $value) {
            if (in_array($key, $ignoreParamKeys, true)) {
                continue;
            }
 
            $paramKey = ($prefix ? $prefix . ':' : '') . $key;
 
            if (is_object($value)) {
                $value = get_object_vars($value);
            }
 
            if (is_array($value)) {
                    $subArray = self::getParamsToSign($value, $ignoreParamKeys, $currentLevel + 1, $paramKey);
                    $paramsToSign = array_merge($paramsToSign, $subArray);               
            } else {
                if (is_bool($value)) {
                    $value = $value ? '1' : '0';
                } else {
                    $value = (string)$value;
                }
 
                $paramsToSign[$paramKey] = (string)$paramKey . ':' . $value;
            }
        }
 
        if ($currentLevel == 1) {
            ksort($paramsToSign, SORT_NATURAL);
        }
 
        return $paramsToSign;
    }


// Пример использования

// указание секретного ключа и параметров вызова платёжной формы
$secretKey = "jwfbfjhewbrw33383kr3js9d987";
 
$params = [
    'project_id' => 57123,     
    'payment_amount' => 1815,
    'payment_currency' => 'EUR',
    'customer_id' => 'customer_112',
    'payment_id' => 'payment_443',
];
 
// формирование подписи
$params['signature'] = Signer::sign($params, $secretKey);
 
// получение ссылки для вызова платёжной формы
$uriParams = http_build_query($params);
$link = implode('?', ['https://paymentpage.ecommpay.com/payment', $uriParams]);

2 Обеспечиваем приём оповещений

Чтобы оперативно узнавать о результатах платежей и получать другую значимую информацию, следует настроить приём и обработку программных оповещений от платёжной платформы. Это делается в три шага:

1. Определяем и задаём в платёжной платформе адрес для приёма веб-сервисом оповещений по проекту (сначала можно задать один общий адрес, а после — несколько, под разные события). Для этого открываем в интерфейсе Dashboard раздел Проекты и используем инструменты на вкладке Оповещения.
2. Настраиваем проверку целостности и разбор оповещений, поступающих на указанный URL, с использованием SDK.
3. Настраиваем отправку синхронных HTTP-ответов о приёме оповещений: 200 ОК если подпись корректна и 400 Bad Request если подпись некорректна.

// Работа с оповещениями. Пример сверки полученной подписи с расчётной

require_once 'Signer.php';

$secretKey = '<secret_key>';

$requestBody = '{
       "project_id": 57123,
       "payment": {
           "id": "payment_443",
           "type": "purchase",
           "status": "success",
           "date": "2022-03-03T10:50:29+0000",
           "method": "card",
           "sum": {
               "amount": 1815,
               "currency": "EUR"
           },
           "description": "Test payment"
       },
       "customer": {
           "id": "customer_112",
           "ip": "127.0.0.1",
           "phone": "+60-3-xxxx-xxxx",
           "email": "jane.doe@testmail.com"
       },
       "operation": {
           "id": 15788000002076,
           "type": "sale",
           "status": "success",
           "date": "2022-03-03T10:50:29+0000",
           "sum_initial": {
               "amount": 1815,
               "currency": "EUR"
           },
           "code": "0",
           "message": "Success"
       },
       "signature": "zwoFECy7H+WZFziw9IgR9031Uu878TuIv3dhFyHvCuvzIdRAzDQA=="
   }';

$requestBodyArray = json_decode($requestBody, true);

$actualSignature = $requestBodyArray['signature'];
unset($requestBodyArray['signature']);
$expectedSignature = Signer::sign($requestBodyArray, $secretKey);

print_r('Actual signature: ' . $actualSignature . PHP_EOL);
print_r('Expected signature: ' . $expectedSignature . PHP_EOL);

if ($expectedSignature === $actualSignature) {
    print_r('Signatures are equal');
} else {
    print_r('Signatures are not equal');
}

print_r(PHP_EOL);

Описания используемых статусов платежей можно найти в отдельном разделе, а описание оповещений и работы с ними — в отдельной статье. При этом важно помнить, что в случаях, когда пользователь не подтверждает оплату в платёжной форме, платёж не регистрируется (и статуса по нему тоже нет).

Извлечённую из оповещений информацию можно использовать для оперативного обновления статусов заказов в веб-сервисе, информирования пользователей и других целей — в соответствии с моделью работы вашего веб-сервиса.

Рис.: Python

1 Обеспечиваем подписывание данных

# Кодирование алгоритма
import hmac
import base64
import hashlib
 
 
class Signer:
    def getSign(self, params, key):
        byteKey = key.encode()
        paramsPrepared = self.getParamsToSign(params)
        toSignString = ';'.join(paramsPrepared.values())
        hmacObj = hmac.new(byteKey, toSignString.encode(), hashlib.sha512)
 
return base64.b64encode(hmacObj.digest())
 
def getParamsToSign(self, params, currentLevel = 1, prefix = ''):
        paramsToSign = dict()
 
for paramKey in params.keys():
 
newParamKey = (prefix + ':' if prefix else '') + paramKey
 
if isinstance(params[paramKey], (dict)):
                subDict = self.getParamsToSign(params[paramKey], currentLevel + 1, newParamKey)
                paramsToSign.update(subDict)
else:
                if isinstance(params[paramKey], (bool)):
                    value = '1' if params[paramKey] == True else '0'
                else:
                    value = str(params[paramKey])
 
paramsToSign[newParamKey] = str(newParamKey + ':' + value)
 
sortedParams = dict()
 
for key in sorted(paramsToSign.keys()):
            sortedParams[key] = paramsToSign[key]
 
return sortedParams


# Пример использования

# указание параметров вызова платёжной формы и секретного ключа
import urllib.parse
import Signer
 
params = {
    'project_id': 57123, 
    'payment_amount': 1815,
    'payment_currency': 'EUR',
    'customer_id': 'customer_112',
    'payment_id': 'payment_443',
}

# формирование подписи
signer = Signer.Signer()
 
params['signature'] = signer.getSign(params, '<secret_key>')
 
print(params['signature'])

# получение ссылки для вызова платёжной формы
jointParams = urllib.parse.urlencode(params)
 
link = '?'.join(['https://paymentpage.ecommpay.com/payment', jointParams])

2 Обеспечиваем приём оповещений

Чтобы оперативно узнавать о результатах платежей и получать другую значимую информацию, следует настроить приём и обработку программных оповещений от платёжной платформы. Это делается в три шага:

1. Определяем и задаём в платёжной платформе адрес для приёма веб-сервисом оповещений по проекту (сначала можно задать один общий адрес, а после — несколько, под разные события). Для этого открываем в интерфейсе Dashboard раздел Проекты и используем инструменты на вкладке Оповещения.
2. Настраиваем проверку целостности и разбор оповещений, поступающих на указанный URL, с использованием SDK.
3. Настраиваем отправку синхронных HTTP-ответов о приёме оповещений: 200 ОК если подпись корректна и 400 Bad Request если подпись некорректна.

# Работа с оповещениями. Пример сверки полученной подписи с расчётной

from Signer import Signer
import base64

secretKey = '<secret_key>'
params = {
    "project_id": 57123,
    "payment": {
        "id": "payment_443",
        "type": "purchase",
        "status": "success",
        "date": "2022-03-03T10:50:29+0000",
        "method": "card",
        "sum": {
            "amount": 1815,
            "currency": "EUR"
        },
        "description": "Gagarin set"
    },
    "customer": {
        "id": "customer_112",
        "ip": "127.0.0.1",
        "phone": "+60-3-xxxx-xxxx",
        "email": "jane.doe@testmail.com"
    },
    "operation": {
        "id": 15788000002076,
        "type": "sale",
        "status": "success",
        "date": "2022-03-03T10:50:29+0000",
        "sum_initial": {
            "amount": 1815,
            "currency": "EUR"
        },
        "code": "0",
        "message": "Success"
    },
    "signature": "zwoFECy7H+WZFziw9IgR90SEmC+o3qXD7OIaHqgQuqcSwBC09W6yQA=="
}

signer = Signer()
actualSign = params['signature']
del params['signature']
expectedSign = signer.getSign(params, secretKey).decode()

print('Actual signature:' + actualSign)
print('Expected signature:' + expectedSign)

if (expectedSign == actualSign):
    print('Signature is correct')
else:
    print('Signature is incorrect')

Описания используемых статусов платежей можно найти в отдельном разделе, а описание оповещений и работы с ними — в отдельной статье. При этом важно помнить, что в случаях, когда пользователь не подтверждает оплату в платёжной форме, платёж не регистрируется (и статуса по нему тоже нет).

Извлечённую из оповещений информацию можно использовать для оперативного обновления статусов заказов в веб-сервисе, информирования пользователей и других целей — в соответствии с моделью работы вашего веб-сервиса.

Рис.: JavaScript

1 Обеспечиваем подписывание данных

// Кодирование алгоритма
import hmacSHA512 from 'crypto-js/hmac-sha512';
import encBase64 from 'crypto-js/enc-base64';

export class Signer {
  getSign(params, key) {
    const paramsPrepared = this.getParamsToSign(params, 1);

    const joinedString = Object.values(paramsPrepared).join(';');

    const hash = hmacSHA512(joinedString, key);

    return hash.toString(encBase64);
  }

  getParamsToSign(
    params,
    prefix = '',
  ) {
    let paramsToSign = {};
    let value = '';

    let keys = Object.keys(params);
    let key = '';
    for (let i = 0; i < keys.length; i++) {
      key = keys[i];

      let paramKey = (prefix ? prefix + ':' : '') + key;

      if (typeof params[key] === 'object') {
        let subParams = this.getParamsToSign(
            params[key],
            paramKey,
          );

          Object.assign(paramsToSign, subParams);
      } else {
        if (typeof params[key] === 'boolean') {
          value = params[key] === true ? '1' : '0';
        } else {
          value = params[key].toString();
        }

        paramsToSign[paramKey] = paramKey + ':' + value;
      }
    }

    let orderedKeys = Object.keys(paramsToSign).sort();

    let ordered = {};

    for (let k = 0; k < orderedKeys.length; k++) {
      ordered[orderedKeys[k]] = paramsToSign[orderedKeys[k]];
    }

    return ordered;
  }
}

// Пример использования
import { Signer } from './signer.js';

// указание параметров вызова платёжной формы и секретного ключа
let params = {
  project_id: 57123,
  payment_amount: 1815,
  payment_currency: 'EUR',
  customer_id: 'customer_112',
  payment_id: 'payment_443',
};

// формирование подписи
params['signature'] = new signer().getSign(params, '<secret_key>');

// получение ссылки для вызова платёжной формы
const uriParams = Object.keys(params)
  .sort()
  .reduce((paramsArray, key) => {
    paramsArray.push(key + '=' + encodeURIComponent(params[key]));
    return paramsArray;
  }, []);
const link = [
  'https://paymentpage.ecommpay.com/payment',
  uriParams.join('&'),
].join('?');

2 Обеспечиваем приём оповещений

Чтобы оперативно узнавать о результатах платежей и получать другую значимую информацию, следует настроить приём и обработку программных оповещений от платёжной платформы. Это делается в три шага:

1. Определяем и задаём в платёжной платформе адрес для приёма веб-сервисом оповещений по проекту (сначала можно задать один общий адрес, а после — несколько, под разные события). Для этого открываем в интерфейсе Dashboard раздел Проекты и используем инструменты на вкладке Оповещения.
2. Настраиваем проверку целостности и разбор оповещений, поступающих на указанный URL, с использованием SDK.
3. Настраиваем отправку синхронных HTTP-ответов о приёме оповещений: 200 ОК если подпись корректна и 400 Bad Request если подпись некорректна.

// Работа с оповещениями. Пример сверки полученной подписи с расчётной

import { Signer } from './Signer';

const secretKey = '<secret_key>';

const params = {
    "project_id": 57123,
    "payment": {
        "id": "payment_443",
        "type": "purchase",
        "status": "success",
        "date": "2022-03-03T10:50:29+0000",
        "method": "card",
        "sum": {
            "amount": 1815,
            "currency": "EUR"
        },
        "description": "Gagarin set"
    },
    "customer": {
        "id": "customer_112",
        "ip": "127.0.0.1",
        "phone": "+60-3-xxxx-xxxx",
        "email": "jane.doe@testmail.com"
    },
    "operation": {
        "id": 15788000002076,
        "type": "sale",
        "status": "success",
        "date": "2022-03-03T10:50:29+0000",
        "sum_initial": {
            "amount": 1815,
            "currency": "EUR"
        },
        "code": "0",
        "message": "Success"
    },
    "signature": "zwoFECy7H+WZFziw9IgR90SHvCuvqXD7OIaHqgQuqcSwBC09W6yQA=="
};

const actualSignature = params['signature'];
delete params.signature;
const expectedSignature = (new signer()).getSign(params, secretKey);

console.log('Actual: ' + actualSignature);
console.log('Expected: '+expectedSignature);

if (actualSignature == expectedSignature) {
    console.log('Signatures is correct');
} else {
    console.log('Signature is incorrect');
}

Описания используемых статусов платежей можно найти в отдельном разделе, а описание оповещений и работы с ними — в отдельной статье. При этом важно помнить, что в случаях, когда пользователь не подтверждает оплату в платёжной форме, платёж не регистрируется (и статуса по нему тоже нет).

Извлечённую из оповещений информацию можно использовать для оперативного обновления статусов заказов в веб-сервисе, информирования пользователей и других целей — в соответствии с моделью работы вашего веб-сервиса.

Рис.: Открытие в отдельной вкладке браузера

Чтобы открыть платёжную форму в виде отдельной HTML-страницы, следует использовать ссылку, полученную при подписывании данных. Это ссылка формата https://paymentpage.ecommpay.com/payment?<parameters>, где <parameters> — строка с названиями и значениями параметров вызова.

HTTP-запрос с применением метода GET в таком случае может выглядеть следующим образом:

GET
/payment?payment_currency=EUR&project_id=42&payment_amount=1000&
customer_id=123&payment_id=4438&signature=AE5hmtzdP0Dt7qGTg... HTTP/1.1

Host: https://paymentpage.ecommpay.com

Рис.: Подключение библиотек

<head>
...
// подключение CSS-библиотеки
<link rel="stylesheet" href="https://paymentpage.ecommpay.com/shared/merchant.css" /> 

// подключение JavaScript-библиотеки
<script type="text/javascript" src="https://paymentpage.ecommpay.com/shared/merchant.js">
</script>
...
</head>

Рис.: Открытие в модальном окне

Чтобы открыть Payment Page в модальном окне по щелчку кнопки на странице веб-сервиса, можно использовать метод bind JavaScript-объекта EPayWidget. При обращениях к этому объекту следует указывать идентификатор кнопки (pay_button_id), объект с параметрами вызова Payment Page (configObj) и HTTP-метод отправки запросов (method):

EPayWidget.bind('pay_button_id',            // идентификатор кнопки
                { payment_id: 'payment_443',         // идентификатор платежа
                  payment_amount: 1815,              // сумма платежа
                  payment_currency: 'EUR',           // код валюты платежа
                  project_id: 57123,                 // идентификатор проекта
                  customer_id: 'customer_112',       // идентификатор пользователя
                  signature: 'YWb6Z20ByxpQ30hfTI' }, // подпись
                 'post')  // HTTP-метод   

Рис.: Открытие непосредственно на странице, в элементе iframe

Чтобы открыть Payment Page в элементе iframe по щелчку кнопки на странице веб-сервиса, как и в случае с модальным окном, можно использовать метод bind JavaScript-объекта EPayWidget. При обращениях к этому объекту следует указывать идентификатор кнопки (pay_button_id), объект с параметрами вызова Payment Page (configObj), идентификатор элемента, в котором необходимо отобразить платёжную форму (target_element), и HTTP-метод отправки запросов (method):

EPayWidget.bind('pay_button_id',             // идентификатор кнопки
                { payment_id: 'payment_443',          // идентификатор платежа
                  payment_amount: 1815,               // сумма платежа
                  payment_currency: 'EUR',            // код валюты платежа
                  project_id: 57123,                  // идентификатор проекта
                  customer_id: 'customer_112',        // идентификатор пользователя
                  signature: 'YWb6Z20ByxpQ30hfTI' },  // подпись
                  target_element: 'widget-container', // идентификатор элемента
                 'post') // HTTP-метод