获取用户的个人养老金账户

更新时间:2024.08.14

接口说明

支持商户: 【银行机构】

请求方式: 【POST】

请求参数

BODY 包体参数

session_id 选填 string

【字段名称】跳转银行前端时生成的会话ID


user_true_name 必填 string

【用户真实姓名】用户真实姓名


user_identify_card_num 必填 string

【用户身份证号】用户身份证号


corpno 必填 string

【字段名称】固定值填为:"weibao",银行侧建议必填,用于银行侧识别跳转来源

 

请求示例

1{
2    "session_id": "ABC123",
3    "user_true_name": "张三",
4    "user_identify_card_num": "110151000000000000",
5    "corpno": "weibao",
6}

应答参数

200 OK

 

user_true_name 必填 string

【用户姓名】用户姓名


user_bank_phone_num 必填 string

【预留手机号】用于从个养账户扣款时验证


user_identify_card_num 必填 string

【身份证号】身份证号


pension_bank_card_num 必填 string

【个养资金账户】个养资金账户


pension_create_time 选填 string

【个养账户创建时间】UNIX时间戳,单位秒


pension_close_time 选填 string

【个养账户注销时间】UNIX时间戳,单位秒


pension_status 必填 integer

【个养账户状态】
1:已开通
2:已注销
3:未开通
4:他行已开通

请求示例

200 OK

1{  
2  "user_true_name" : "张三",
3  "user_bank_phone_num" : "13800000000",
4  "user_identify_card_num" : "110151000000000000",
5  "pension_bank_card_num" : "123456",
6  "pension_status" : 1
7}

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_PARAMETERS

输入参数错误

检查输入参数

401

SIGN_ERROR

签名错误

检查签名是否正确

403

RULE_LIMIT

业务规则限制

因业务规则限制请求频率,请查看接口返回的详细信息

412

INVALID_USER_INFO

用户信息不匹配

检查用户姓名,用户身份证对应关系

412

SESSION_NOT_FOUND

未使用该session_id调转银行小程序

检查是否有session_id跳转银行小程序记录

500

SYSTEM_ERROR

系统错误

系统异常,请用相同参数重新调用

 

 

 

 

 

 

 

 

 

 

 

 

 

反馈
咨询
目录
置顶