cloudpayments 1.0

CloudPayments Python Client Library

Клиент для платежного сервиса CloudPayments. Позволяет обращаться к API CloudPayments из кода на Python.

Установка

pip install cloudpayments

Требования

Python 2.6+ или 3+

Использование

from cloudpayments import CloudPayments

client = CloudPayments('public_id', 'api_secret')
client.test()

При создании клиента задаются аутентификационные параметры: Public ID и Api Secret. Оба этих значения можно получить в личном кабинете.

Обращение к API осуществляется через методы клиента.

Тестовый метод

test()

В случае успеха метод ничего не возвращает, при ошибке бросает исключение.

Оплата по криптограмме

charge_card(self, cryptogram, amount, currency, name, ip_address,
            invoice_id=None, description=None, account_id=None,
            email=None, data=None, require_confirmation=False)

currency — одна из констант, определенных в классе Currency

data — произвольные данные, при отправке будут сериализованы в JSON.

require_confirmation — если установлено в True, платеж будет выполняться по двухстадийной схеме.

В случае успеха возвращает объект типа Transaction (если не требуется 3-D Secure аутентификация) либо Secure3d (если требуется).

Завершение оплаты после прохождения 3-D Secure

finish_3d_secure_authentication(self, transaction_id, pa_res)

В случае успеха возвращает объект типа Transaction.

Оплата по токену

charge_token(self, token, account_id, amount, currency,
             ip_address=None, invoice_id=None, description=None,
             email=None, data=None, require_confirmation=False)

currency — одна из констант, определенных в классе Currency

data — произвольные данные, при отправке будут сериализованы в JSON.

require_confirmation — если установлено в True, платеж будет выполняться по двухстадийной схеме.

В случае успеха возвращает объект типа Transaction.

Подтверждение оплаты

confirm_payment(self, transaction_id, amount)

В случае успеха метод ничего не возвращает, при ошибке бросает исключение.

Отмена оплаты

void_payment(self, transaction_id)

В случае успеха метод ничего не возвращает, при ошибке бросает исключение.

Возврат денег

refund(self, transaction_id, amount)

В случае успеха метод ничего не возвращает, при ошибке бросает исключение.

Проверка статуса платежа

find_payment(self, invoice_id)

В случае успеха возвращает объект типа Transaction.

Выгрузка списка транзакций

list_payments(self, date, timezone=None)

date — объект типа datetime.date.

timezone — одна из констант, определенных в классе Timezone.

В случае успеха возвращает список объектов типа Transaction.

Создание подписки

create_subscription(self, token, account_id, amount, currency,
                    description, email, start_date, interval, period,
                    require_confirmation=False, max_periods=None)

currency — одна из констант, определенных в классе Currency.

start_date — объект типа datetime.datetime.

interval — одна из констант, определенных в классе Interval.

В случае успеха возвращает объект типа Subscription.

Запрос статуса подписки

get_subscription(self, subscription_id)

В случае успеха возвращает объект типа Subscription.

Изменение подписки

update_subscription(self, subscription_id, amount=None, currency=None,
                    description=None, start_date=None, interval=None,
                    period=None, require_confirmation=None,
                    max_periods=None)

currency — одна из констант, определенных в классе Currency.

start_date — объект типа datetime.datetime.

interval — одна из констант, определенных в классе Interval.

В случае успеха возвращает объект типа Subscription.

Отмена подписки

cancel_subscription(self, subscription_id)

В случае успеха метод ничего не возвращает, при ошибке бросает исключение.

Отправка счета по почте

create_order(self, amount, currency, description, email=None,
             send_email=None, require_confirmation=None,
             invoice_id=None, account_id=None, phone=None,
             send_sms=None, send_whatsapp=None, culture_info=None)

currency — одна из констант, определенных в классе Currency.

culture_info — одна из констант, определенных в классе CultureInfo.

В случае успеха возвращает объект типа Order.

Авторы

Разработано в Antida software. Мы создаем SaaS-продукты и сервисы, интегрированные с платежными системами. Пишите нам, если вам нужна консультация по работе с биллинговыми системами: [e-mail].

Лицензия

MIT