Yiller[Alipay自动支付]使用手册

## 目的
能自动化购买支持支付宝渠道付款的商品，无需人工干涉

## 使用
适用于抖币充值，商城抢单以及任何支持支付宝H5支付的场景

## 接口

### 自动充值

Url: https://pay.yiller.top/api/_auto_payment_by_alipay

Method: POST

| 请求参数 | 简介 | 描述 |
| --- | --- | --- |
| identity_key | 密钥 | 识别当前请求者身份【一个密钥最多绑定三个支付宝账号】 |
| alipay_account | 支付宝账号，用于付款 | 该账号绑定的手机号需要能够接收验证码
| payment_type | 类型 | 抖币充值时该参数为：CN_TIKTOK
| payment_account | 支付账号 | 当type=CN_TIKTOK时，该值为抖音号或者手机号
| payment_amount | 支付金额 | 单位分， 也就是amount=100时，充值金额为1RMB |
| prepare_order_no | 前置订单号 | 重复前置订单号不予处理,请保证在自己系统中唯一 |

1. 所有字段必填 2. 填写的支付宝账号必须已与密钥绑定 3. 请勿频繁刷新该接口，正常平均响应时长为15~30s，请做好超时处理 4. 支付金额必须为100的倍数，且不能为零

| 返回参数 | 简介 | 描述 |
| --- | --- | --- |
| order_status | 订单状态 | SUCCESS、FAILURE、INPROGRESS |
| error_message | 错误描述 | order_status=FAILURE时会填充此值
| error_code | 错误码 | 00， 01， 02， 03， 04
| alipay_order_no | 支付宝订单号 | 根据此订单号可以在支付宝查账
| prepare_order_no | 前置订单号 | 前置订单号，用户所传
| complete_timestamp | 订单完成时间 | 订单完成时间

*支付宝账号所绑定的手机号必须在安卓机上，并安装如下软件用于转发短信* 软件下载完成后，在url schema中配置推送地址 https://pay.yiller.top/api/_receive_sms_code?phone={{phone}}&msg={{msg}} 
其它类似软件亦可

软件下载地址：
https://gitee.com/pp/SmsForwarder/tags

软件具体使用方式：
https://gitee.com/pp/SmsForwarder/wikis/pages?sort_id=5163454&doc_id=1821427

配置完成后,发送短信至手机号进行验证，浏览器访问下列地址查询是否接收到最新短信
https://pay.yiller.top/api/_get_sms_code?phone=xxx

### 订单查询

Url: https://pay.yiller.top/api/_query_order

Method: POST

| 请求参数 | 简介 | 描述 |
| --- | --- | --- |
| identity_key | 密钥 | 识别当前请求者身份【一个密钥最多绑定三个支付宝账号】 |
| prepare_order_no | 前置订单号 | 重复前置订单号不予处理,请保证在自己系统中唯一 |

| 返回参数 | 简介 | 描述 |
| --- | --- | --- |
| order_status | 订单状态 | SUCCESS、FAILURE、INPROGRESS |
| error_message | 错误描述 | order_status=FAILURE时会填充此值
| error_code | 错误码 | 00， 01， 02， 03， 04
| alipay_order_no | 支付宝订单号 | 根据此订单号可以在支付宝查账
| prepare_order_no | 前置订单号 | 前置订单号，用户所传
| complete_timestamp | 订单完成时间 | 订单完成时间