银行卡管理

快捷卡对象

参数

类型

说明

id

String(64)

Adapay生成的快捷绑卡确认id

object

String(20)

快捷卡对象,fast_card

created_time

String(10)

创建时的时间戳

prod_mode

String(4)

是否prod模式,true是prod模式,false是mock模式

app_id

String(64)

控制台 主页面应用的app_id

member_id

String(64)

用户的member_id,只能为英文、数字或者下划线的一种或多种组合

card_id

String(32)

银行卡卡号,只能是数字,长度范围为8~32个字符

tel_no

String(11)

银行卡对应的预留手机号

token_no

String(32)

Adapay生成的快捷卡唯一标识

bank_name

String(64)

银行名称

status

String(16)

当前交易状态,参见 状态 说明

error_code

String(32)

错误码,详见 错误

error_msg

String(128)

错误描述,详见 错误

error_type

String(32)

错误类型,详见 错误

invalid_param

String(32)

当发生参数错误时返回具体的参数名,便于定位错误原因,详见 错误

创建快捷绑卡申请

个人用户使用快捷支付前,对个人用户的银行卡进行验证。该功能实现对用户银行卡进行四要素验证,验证成功后,会向用户银行卡对应的预留手机号发送短信验证码。

请求参数

参数

类型

必填

描述

app_id

String(64)

Y

控制台 主页面应用的app_id

member_id

String(64)

Y

用户的member_id,只能为英文、数字或者下划线的一种或多种组合

card_id

String(32)

Y

银行卡卡号,只能是数字,长度范围为8~32个字符

tel_no

String(11)

Y

银行卡对应的预留手机号

vip_code

String(3)

N

信用卡验证码,若银行卡为信用卡时必填,银行卡背面签名条末三位

expiration

String(4)

N

信用卡有效期,若银行卡为信用卡时必填

响应

参数

类型

说明

id

String(64)

Adapay生成的快捷绑卡申请id

object

String(20)

快捷卡对象,fast_card

created_time

String(10)

创建时的时间戳

prod_mode

String(4)

是否prod模式,true是prod模式,false是mock模式

app_id

String(64)

控制台 主页面应用的app_id

member_id

String(64)

用户的member_id,只能为英文、数字或者下划线的一种或多种组合

card_id

String(32)

银行卡卡号,只能是数字,长度范围为8~32个字符

tel_no

String(11)

银行卡对应的预留手机号

status

String(16)

当前交易状态,参见 状态 说明

error_code

String(32)

错误码,详见 错误

error_msg

String(128)

错误描述,详见 错误

error_type

String(32)

错误类型,详见 错误

invalid_param

String(32)

当发生参数错误时返回具体的参数名,便于定位错误原因,详见 错误

调用示例

Java

Map<String, Object> applyParam = new  HashMap<String, Object>();
applyParam.put("app_id", "app_XXXXXXXX");
applyParam.put("member_id", "member_id_test");
applyParam.put("card_id", "666666666666666666666666");
applyParam.put("tel_no", "13888888888");
applyParam.put("vip_code", "321");
applyParam.put("expiration", "0225");
Map<String, Object> result = FastPay.cardApply(applyParam);

成功响应

{
    "app_id":"app_XXXXXXXX",
    "card_id":"666666********6",
    "created_time":"1606356811",
    "id":"0177857511167541248",
    "member_id":"member_id_test",
    "object":"fast_card",
    "prod_mode":"true",
    "status":"succeeded",
    "tel_no":"1388888****"
}

创建快捷绑卡确认

快捷绑卡申请成功后,用户输入收到的短信验证码进行短信验证,若验证成功,Adapay会返回快捷卡唯一标识token_no。若同步返回pending状态时,Adapay会发送 异步消息通知 告知。

请求参数

参数

类型

必填

描述

apply_id

String(64)

Y

Adapay生成的快捷绑卡申请id

sms_code

String(6)

Y

短信验证码

notify_url

String(250)

Y

异步通知地址,url为http/https路径,服务器POST回调,URL 上请勿附带参数

响应

成功时同步返回一个包含 快捷卡对象 的 JSON。

调用示例

Java

Map<String, Object> confirmParam = new  HashMap<String, Object>();
confirmParam.put("apply_id", "0177857511167541248");
confirmParam.put("sms_code", "123456");
confirmParam.put("notify_url", "https://xxxx.com/xxxx");
Map<String, Object> cash = FastPay.cardConfirm(confirmParam);

成功响应

{
    "app_id":"app_XXXXXXXX",
    "apply_id":"0177857511167541248",
    "bank_name":"农业银行",
    "card_id":"666666********6",
    "created_time":"1606356811",
    "id":"0177859088938876928",
    "member_id":"member_id_test",
    "object":"fast_card",
    "prod_mode":"true",
    "status":"succeeded",
    "tel_no":"1388888****",
    "token_no":"10000067502"
}

查询快捷卡对象列表

查询已绑定的快捷银行卡列表。

请求参数

参数

类型

必填

说明

app_id

String(64)

Y

控制台 主页面应用的app_id

member_id

String(64)

Y

用户的member_id,只能为英文、数字或者下划线的一种或多种组合

token_no

String(32)

N

Adapay生成的快捷卡唯一标识

响应

参数

类型

说明

object

String(8)

快捷卡对象列表,list

prod_mode

String(4)

是否prod模式,true是prod模式,false是mock模式

app_id

String(64)

控制台 主页面应用的app_id

member_id

String(64)

用户的member_id,只能为英文、数字或者下划线的一种或多种组合

token_no

String(32)

Adapay生成的快捷卡唯一标识

has_more

boolean

是否还有更多,true-是,false-否

fast_cards

List

快捷卡对象 的列表,若未查询到结果时,字段为空

status

String(16)

当前交易状态,参见 状态 说明

error_code

String(32)

错误码,详见 错误

error_msg

String(128)

错误描述,详见 错误

error_type

String(32)

错误类型,详见 错误

invalid_param

String(32)

当发生参数错误时返回具体的参数名,便于定位错误原因,详见 错误

调用示例

Java

Map<String, Object> listParam = new  HashMap<String, Object>();
listParam.put("app_id", "app_XXXXXXXX");
listParam.put("member_id", "member_id_test");
listParam.put("token_no", "10000067502");
Map<String, Object> result = FastPay.cardList(listParam);

成功响应

{
    "app_id":"app_XXXXXXXX",
    "fast_cards":[
        {
            "app_id":"app_XXXXXXXX",
            "bank_name":"农业银行",
            "card_id":"666666********6",
            "created_time":"1606357188",
            "member_id":"member_id_test",
            "object":"fast_card",
            "prod_mode":"true",
            "status":"succeeded",
            "tel_no":"1388888****",
            "token_no":"10000067502"
        }
    ],
    "has_more":false,
    "member_id":"member_id_test",
    "object":"list",
    "prod_mode":"true",
    "status":"succeeded",
    "token_no":"10000067502"
}