English
Log In
You can then view all documents
成长工具/短剧SDK/短剧-服务端接口/登录/支付加(验)签接口
登录/支付加(验)签接口
Last updated 2024-02-28 17:14:49

注意:服务端使用的支付密钥appSecret 和客户端是不一样的,请联系穿山甲对接同学获取。

1、业务侧登录态授权给SDK:

  • 功能简述:业务侧服务端通过把业务侧用户id,即 uid+timestamp+nonce 和server key加签之后,传递给穿山甲SDK,用以实现业务侧登录态的授权登录功能
  • 字段说明:

字段

类型

示例

说明

ouid

string

"123456"

业务侧的用户ID

timestamp


int

123123123


unix时间戳,秒。注意这里的时间戳,关注服务器时钟。SDK Server会进行校验

nonce

string

"1234567890123456"

16位随机字符串

  • 加签方法:
复制

2、业务侧服务端创建订单参数:

  • 功能简述:用户选择了套餐之后,调用业务侧服务端接口,业务侧服务端生成订单参数,传递给SDK,用以下单支付
  • 字段说明:

字段

类型

示例

必需

说明

site_id

int

123123

穿山甲应用ID

ouid

string

"123456"

用户id,需要和用户的登录态id保持一致

combo_id

int

123456

套餐id

shortplay_id

int

6


当combo_id为单部购买时必需

短剧id,当combo_id为单部购买时必需

order_no

string

"SP2020202020"

业务侧生成的唯一单号,可以随机生成,如果业务侧有订单系统,可以是订单单号。业务侧保持唯一

order_time

int

1231923901

下单时间

notify_address

string

https://xxxxx

回调通知


expire_second

int

1800


订单过期时间,秒。默认为1800

timestamp

int

1231923901

unix时间戳,秒,注意时钟问题

nonce

string

"ABCDEFGH12345678"

16位随机值

  • 加签方法:同上

3、支付结果回调:

  • 功能简述:将用户支付成功并且权益发放成功消息通知给开发者
  • 接口说明
    1. 回调地址会使用开发者在创建订单时传入的notify_address
    2. 回调一定要做验签处理,防止收到假通知
    3. 只有权益发放成功才有回调,支付失败或者权益发放失败不会回调
    4. 通知失败重试最多10次,前三次间隔1秒,后续重试1分钟间隔
    5. 在开发者服务端收到回调且处理成功后,需要按以下 json 返回表示处理成功,否则服务端会认为通知失败进行重试。
复制
  • 回调参数

名称

类型

是否必填

最大长度

描述

示例值

timestamp

int

12

Unix 时间戳,字符串类型

1702373521

nonce

string

8

随机数

OwlJsUvt

msg

string

-

订单信息的 json 字符串

{\"site_id\":5434881,\"out_order_no\":\"PAY_5434881_hhhzp1_b09f0b5b-c20a-4792-95ad-7f60ced880b3\",\"order_id\":\"TR5434881_5vfbW6H0vqWVirBec4gL3e\",\"ouid\":\"hhhzp1\",\"status\":3,\"total_amount\":1,\"pay_type\":\"ALIPAY\",\"combo_id\":933889026,\"membership_duration\":1,\"sp_id\":2368,\"event_time\":1702373462,\"extra\":\"\"}

type

string

32

回调类型标记,支付成功回调为"payment"

payment

sign

string

128

签名

5e31d688881a7f2e0527cb09400dfcabc4a832920c80c3c5a1e7ca3fe558da41

  • msg 列表单项

名称

类型

是否必填

描述

示例值

site_id

int

应用ID

5434881

out_order_no

string

开发者侧的订单号

PAY_5434881_hhhzp1_b09f0b5b-c20a-4792-95ad-7f60ced880b3

order_id

string

穿山甲订单号

TR5434881_5vfbW6H0vqWVirBec4gL3e

ouid

string

开发者用户ID

hhhzp1

total_amount

int

支付金额,单位为分

100,即1元

status

int

3:代表成功

3

pay_type

string

交易类型 ALIPAY:支付宝 WECHAT:微信 BYTEPAY:抖音支付(含抖音月付)

ALIPAY

combo_id

int

套餐ID,当combo_id为单部购买时必需

933889026

membership_duration

int

购买的会员周期 Day:1 Week:2 Month:3 Quarter:4 Year:5

1

sp_id

int

购买的短剧ID

1125

event_time

int

权益发放时间,Unix 时间戳,字符串类型

1702370954

extra

string

预下单时开发者传入字段


  • 验签方法
复制
  • 回调示例
复制
  • 响应参数

名称

类型

是否必填

描述

示例值

ret_code

string

返回码,0代表成功

0

ret_message

string

返回码信息

成功

  • 响应示例
复制

Contents
Contact us