×

Documentation: gocream-labs.github.io/pysberbank

Python-клиент для унаследованного API СберБанка, который ЮKassa сохраняет для компаний, перешедших из Сбера. Это не клиент для современного API ЮKassa.

Описание протокола - инструкция ЮKassa.

Архивные материалы СберБанка - документация API и тестовые карты.

Installation

Требуется Python 3.10 или новее.

pip install gocream-pysberbank

Для предварительных версий используйте pip install --pre gocream-pysberbank.

from gocream_pysberbank import SberbankClient
from gocream_pysberbank.constants import DESCRIPTION_BY_ACTION_CODE

Для совместимости с прежним API сохранены имена Sberbank и SberbankPaymentApi.

Quick Start

from gocream_pysberbank import SberbankClient

client = SberbankClient(
    username="merchant-api",
    password="password-from-secret-storage",
    url="https://gateway.example/payment/{api_type}/{method}",
)

Замените URL адресом шлюза из настроек вашего подключения. Если url не передан, используется исторический адрес https://3dsec.sberbank.ru/payment/{api_type}/{method}. Вместо пары username/password можно передать token.

Клиент предоставляет методы register, reverse, refund, order_status и order_status_extended. Параметры **kwargs передаются в Requests; это не произвольные параметры платёжного API. По умолчанию timeout равен (3, 27) секундам на соединение и чтение.

При переходе со старого пакета замените импорты pysberbank на gocream_pysberbank, включая пути моков и имя логгера.

Documentation

• API Reference: Client, Payments, Order Status, Exceptions, Constants.
• Project: Known Issues, Roadmap, Changelog.
• Development: Contributing, Releasing.