# установка
pip install python-alipay-sdk --upgrade
# Для Python 2 используйте: pip install python-alipay-sdk==1.1

# openssl
OpenSSL> genrsa -out app_private_key.pem 2048  # файл приватного ключа
OpenSSL> rsa -in app_private_key.pem -pubout -out app_public_key.pem # экспортировать публичный ключ
OpenSSL> exit
```Публичный ключ, загруженный с open.alipay.com, представляет собой строку, которую напрямую не распознает эта библиотека, убедитесь, что он окружен

Также есть [пример](https://github.com/fzlee/alipay/blob/master/tests/certs/ali/ali_public_key.pem) для вашего ознакомления

#### Инициализация
```python
from alipay import AliPay, DCAlipay, ISVAliPay
from alipay.utils import AliPayConfig

def api_alipay_xxx(self, out_trade, total_amount, **kwargs):
    ...
    biz_content.update(kwargs)

# Для пользователей Python 2 (вы должны подумать о переходе на Python 3),
# убедитесь, что строки с не-ASCII символами закодированы в utf-8
subject = u"тестовый заказ".encode("utf8")
# Для пользователей Python 3, просто используйте стандартную строку
subject = "测试订单"

# Оплата через веб, откройте этот URL в вашем браузере: https://openapi.alipay.com/gateway.do? + order_string
order_string = alipay.api_alipay_trade_page_pay(
    out_trade_no="20161112",
    total_amount=0.01,
    subject=subject,
    return_url="https://example.com",
    notify_url="https://example.com/notify" # этот параметр необязателен
)
```#### <a name="alipay.trade.wap.pay"></a>[alipay.trade.wap.pay](https://docs.open.alipay.com/60/104790)

```python
# Оплата через WAP, откройте этот URL в вашем браузере: https://openapi.alipay.com/gateway.do? + order_string
order_string = alipay.api_alipay_trade_wap_pay(
    out_trade_no="20161112",
    total_amount=0.01,
    subject=subject,
    return_url="http://example.com",
    notify_url="https://example.com/notify" # этот параметр необязателен
)

# Оплата через приложение, просто передайте order_string в ваш Android или iOS клиент
order_string = alipay.api_alipay_trade_app_pay(
    out_trade_no="20161112",
    total_amount=0.01,
    subject=subject,
    notify_url="https://example.com/notify" # этот параметр необязателен
)

# Оплата через мини-программу
alipay.api_alipay_trade_create(
    out_trade_no="20161112",
    total_amount=0.01,
    subject=subject,
    buyer_id="",
    notify_url="https://example.com/notify" # этот параметр необязателен
)

import json
from flask import Flask
from flask import request
app = Flask(__name__)

@app.route('/', methods=["GET", "POST"])
def hello_world():
    data = request.form.to_dict()
    # подпись должна быть удалена
    signature = data.pop("sign")

    print(json.dumps(data))
    print(signature)

    # проверка
    success = alipay.verify(data, signature)
    if success and data["trade_status"] in ("TRADE_SUCCESS", "TRADE_FINISHED"):
        print("транзакция успешна")
    return 'Привет, Мир!'
```И также пример для Django
```python

def hello_world(request):
    # для пользователей Django
    data = request.dict()
    # для пользователей rest_framework
    data = request.data

    signature = data.pop("sign")

    # проверка
    success = alipay.verify(data, signature)
    if success and data["trade_status"] in ("TRADE_SUCCESS", "TRADE_FINISHED"):
        print("транзакция успешна")
    return 'Привет, мир!'

# сбор всех параметров, отправленных от сервера Alipay, и помещение их в словарь под названием data
data = {
     "subject": "тестовый заказ",
     "gmt_payment": "2016-11-16 11:42:19",
     "charset": "utf-8",
     "seller_id": "xxxx",
     "trade_status": "TRADE_SUCCESS",
     "buyer_id": "xxxx",
     "auth_app_id": "xxxx",
     "buyer_pay_amount": "0.01",
     "version": "1.0",
     "gmt_create": "2016-11-16 11:42:18",
     "trade_no": "xxxx",
     "fund_bill_list": "[{\"amount\":\"0.01\",\"fundChannel\":\"ALIPAYACCOUNT\"}]",
     "app_id": "xxxx",
     "notify_time": "2016-11-16 11:42:19",
     "point_amount": "0.00",
     "total_amount": "0.01",
     "notify_type": "trade_status_sync",
     "out_trade_no": "xxxx",
     "buyer_logon_id": "xxxx",
     "notify_id": "xxxx",
     "seller_email": "xxxx",
     "receipt_amount": "0.01",
     "invoice_amount": "0.01",
     "sign": "xxx"
}
signature = data.pop("sign")
success = alipay.verify(data, signature)
if success and data["trade_status"] in ("TRADE_SUCCESS", "TRADE_FINISHED"):
    print("транзакция успешна")

alipay = AliPay(appid="", ...)
``````markdown
result = alipay.api_alipay_trade_pay(
    out_trade_no="out_trade_no",
    scene="bar_code/wave_code",
    auth_code="auth_code",
    subject="тема",
    discountable_amount=10,
    total_amount=20,
    notify_url="https://example.com/notify" # это необязательно
)
``````python
if result["code"] == "10000":
    print("Заказ оплачен")
```#### <a name="alipay.trade.precreate"></a>[alipay.trade.precreate/alipay.trade.cancel/alipay.trade.query](https://docs.open.alipay.com/194/105203/)
```python
alipay = AliPay(appid="", ...)

# создание заказа
alipay.api_alipay_trade_precreate(
    subject="test subject",
    out_trade_no="out_trade_no",
    total_amount=100
)

# проверка статуса заказа
оплачен = False
for i in range(10):
    # проверка каждые 3 секунды, всего 10 раз
    print("ожидание 3 секунд")
    time.sleep(3)
    result = alipay.api_alipay_trade_query(out_trade_no="out_trade_no")
    if result.get("trade_status", "") == "TRADE_SUCCESS":
        оплачен = True
        break
    print("не оплачен...")

# если заказ не оплачен в течение 30 секунд, отменить заказ
if оплачен is False:
    alipay.api_alipay_trade_cancel(out_trade_no=out_trade_no)

result = alipay.api_alipay_trade_refund(out_trade_no="xxx", refund_amount="xxx", ...)

if result["code"] == "10000":
    print("успешно")

result = alipay.api_alipay_trade_fastpay_refund_query("20171120", out_trade_no="20171120")

result = {
    'code': '10000',
    'msg': 'Success',
    'out_request_no': '20171120',
    'out_trade_no': '20171120',
    'refund_amount': '20.00',
    'total_amount': '20.00',
    'trade_no': '2017112021001004070200297107'
}

result = alipay.api_alipay_trade_order_settle(
    out_request_no,
    trade_no,
    royalty_parameters
)

#### <a name="alipay.fund.trans.toaccount.transfer"></a>[alipay.fund.trans.toaccount.transfer](https://docs.open.alipay.com/api_28/alipay.fund.trans.toaccount.transfer)
```python
# перевод средств на алипай аккаунт
result = alipay.api_alipay_fund_trans_toaccount_transfer(
    datetime.now().strftime("%Y%m%d%H%M%S"),
    payee_type="ALIPAY_LOGONID/ALIPAY_USERID",
    payee_account="csqnji8117@sandbox.com",
    amount=3.12
)
result = {
    'code': '10000', 
    'msg': 'Success', 
    'order_id': '', 
    'out_biz_no': '', 
    'pay_date': '2017-06-26 14:36:25'
}

result = alipay.api_alipay_fund_trans_order_query(
    out_biz_no="20170626152216"
)
print(result)

isv_alipay = ISVAliPay(
    ...
    app_auth_code="app_auth_code"
)

response = isv_alipay.api_alipay_open_auth_token_app()
response = {
    "code": "10000",
    "msg": "Success",
    "app_auth_token": "201708xxx",
    "app_refresh_token": "201708xxx",
    "auth_app_id": "appid",
    "expires_in": 31536000,
    "re_expires_in": 32140800,
    "user_id": "2088xxxxx"
}

response = isv_alipay.alipay_open_auth_token_app_query()

python -m unittest discover

alipay = AliPay(..., debug=True)
```## [Журнал изменений](https://github.com/fzlee/alipay/blob/master/CHANGELOG.md)