银行卡管理

快捷卡对象

参数

类型

说明

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

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

protocol_no

String(32)

N

招行借记卡绑卡需要上送；示例值：34463343

响应

参数

类型

说明

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"
}

解绑快捷卡对象

该接口适用针对已经快捷卡绑定成功的商户进行解绑。

请求参数

参数

类型

必填

说明

adapay_func_code

String(64)

Y

Adapay接口功能号，该接口填固定值：fast_card.unBindCard

order_no

String(64)

Y

请求订单号，只能为英文、数字或者下划线的一种或多种组合

app_id

String(64)

Y

控制台 主页面应用的app_id

member_id

String(64)

Y

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

token_no

String(32)

Y

Adapay生成的快捷卡唯一标识

notify_url

String(250)

Y

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

响应

参数

类型

说明

object

String(32)

快捷卡解绑对象，unbind_fast_card

prod_mode

String(4)

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

app_id

String(64)

控制台 主页面应用的app_id

member_id

String(64)

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

order_no

String(64)

请求订单号，只能为英文、数字或者下划线的一种或多种组合

token_no

String(32)

Adapay生成的快捷卡唯一标识

status

String(16)

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

error_code

String(32)

错误码，详见 错误

error_msg

String(128)

错误描述，详见 错误

error_type

String(32)

错误类型，详见 错误

invalid_param

String(32)

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

调用示例

Java

Map<String, Object> params = new  HashMap<String, Object>();
params.put("adapay_func_code", "fast_card.unBindCard");
params.put("order_no", "unbind_fast_card_10000067502");
params.put("app_id", "app_******");
params.put("member_id", "member_id_test");
params.put("token_no", "10000067502");
params.put("notify_url", "http://adapay.com/notifyUrl");
Map<String, Object> response = AdapayCommon.requestAdapayUits(params);

成功响应

{
        "app_id":"app_XXXXXXXX",
        "member_id":"member_id_test",
        "order_no":"unbind_fast_card_10000067502",
        "object":"unbind_fast_card",
        "prod_mode":"true",
        "status":"succeeded",
        "token_no":"10000067502"
}

一键绑卡对象

该功能提供一键绑卡能力（对私快捷卡），用于商户对已实名用户进行快速绑卡，其签约地址有效期仅为5分钟。对于绑卡结果，Adapay 会发送 异步消息通知 告知。

请求参数

参数

类型

必填

说明

adapay_func_code

String

Y

Adapay接口功能号，该接口填固定值：fast_card.autoBind

order_no

String(64)

Y

请求订单号，只能为英文、数字或者下划线的一种或多种组合

app_id

String(64)

Y

控制台 主页面应用的app_id

member_id

String(64)

Y

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

tel_no

String(11)

Y

银行卡对应的预留手机号

dc_type

String(1)

Y

银行卡的借贷类型；C:信用卡，D:借记卡

bank_code

String(8)

Y

银行code， 暂支持部分银行，详见 一键绑卡支持的银行代码

verify_front_url

String(100)

Y

前台通知地址（url为http/https路径），绑卡成功，可跳转至指定页面，服务器POST回调，URL 上请勿附带参数

notify_url

String(250)

Y

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

响应

参数

类型

说明

object

String(32)

快捷卡解绑对象，fast_card

prod_mode

String(4)

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

app_id

String(64)

控制台 主页面应用的app_id

member_id

String(64)

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

order_no

String(64)

请求订单号，只能为英文、数字或者下划线的一种或多种组合

tel_no

String(11)

银行卡对应的预留手机号

dc_type

String(1)

银行卡的借贷类型；C:信用卡，D:借记卡

bank_code

String(8)

银行code， 暂支持部分银行，详见 一键绑卡支持的银行代码

verify_detail

json

页面签约URL(HTML)

token_no

String(32)

Adapay生成的快捷卡唯一标识

status

String(16)

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

error_code

String(32)

错误码，详见 错误

error_msg

String(128)

错误描述，详见 错误

error_type

String(32)

错误类型，详见 错误

invalid_param

String(32)

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

调用示例

Java

Map<String, Object> params = new  HashMap<String, Object>();
params.put("adapay_func_code", "fast_card.autoBind");
params.put("order_no", "unbind_fast_card_10000067502");
params.put("app_id", "app_******");
params.put("member_id", "member_id_test");
autoBindCardMap.put("tel_no",  "1312756****");
autoBindCardMap.put("dc_type",  "D");
autoBindCardMap.put("bank_code",  "01040000");
autoBindCardMap.put("verify_front_url",  "http://adapay.com/notifyUrl");
params.put("notify_url", "http://adapay.com/notifyUrl");
Map<String, Object> response = AdapayCommon.requestAdapayUits(params);

成功响应

{
        "app_id":"app_XXXXXXXX",
        "member_id":"member_id_test",
        "order_no":"unbind_fast_card_10000067502",
        "object":"fast_card",
        "prod_mode":"true",
        "tel_no":"1312756****",
        "dc_type":"D",
        "bank_code":"01040000",
        "status":"succeeded",
        "verify_detail":"5UTF-8<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html>**</html>"
}