1、接口介绍
自由职业者进行微信签约时,需先在微信进行授权。商户可通过该跳转链接获取并保存微信授权返回的自由职业者openid。调用【自由职业者签约】接口,作为后续下发微信的收款账户使用。
商户对接参考逻辑如图所示:
自由职业者微信签约、下发对接步骤参考如下:
步骤一、商户自行提供自由者授权入口、授权结果页面,并根据【签约者授权(微信跳转授权)】接口参数要求生成请求链接。
步骤二、商户引导自由职业者使用微信打开链接或者通过微信“扫一扫”打开链接页面确认授权。
步骤三、授权完成后,页面同步跳转商户提供的return_url页面,并携带授权结果参数,商户可根据授权参数展示授权结果。
步骤四、授权成功后,商户保存自由职业者授权openid参数信息,建立授权关联。
步骤五、商户调用【自由职业者签约】接口根据参数要求完成自由职业者签约。其中 收款账号类型 payer_account_type =3,收款账号为授权openid信息。
步骤六、签约完成后,可直接调用任务相关接口,完成下发。
注意:同一自由职业者有且仅存在一条微信签约记录,下发时,根据授权微信标识(即,openid)打款至对应的授权微信账号。若需要变更授权微信,需关注并登录公众号“快薪宝灵活用工平台(微信号:kuaixb8899)”结算中心,通过个人中心变更绑定微信。
支付方式 接口请求地址 微信跳转授权(GET) http://商务人员提供/kxb/signer_auth?请求参数 2、请求参数
序号 请求参数 是否必填 类型 最大长度 描述 示范值 1 merchant_no 是 String 10 快接平台分配的唯一商户号 2017092012 2 agent_no 是 String 20 渠道代理商号,渠道代理商对接必填 202072031384951 3 sign_type 是 String 10 签名类型(1->md5) 1 4 sign 是 String 32 签名 88772a091467bc0fa4790bcad0b1ee69 5 return_url 是 String 255 同步跳转页面地址,使用base64编码后提交 如:地址为“http://www.baidu.com”时,传值aHR0cDovL3d3dy5iYWlkdS5jb20= 6 attach 否 String 255 业务扩展参数,商户自定义,同步跳转时原样返回,使用base64编码后提交 如:参数信息为“user_name=姓名&card_id=350521199507281017”时,传值dXNlcl9uYW1lPeWnk+WQjSZjYXJkX2lkPTM1MDUyMTE5OTUwNzI4MTAxNw== 3、同步跳转携带参数
序号 返回参数 是否必填 字段类型 描述 1 status 是 String 返回码,1为成功, 其他为失败 2 error_msg 是 String 描述,例:授权成功、获取openid失败,请重试 3 openid 否 String 微信授权openid,授权成功时返回 4 attach 否 String base64编码的业务扩展参数,原样返回 5 sign 是 String 签名信息