银行卡绑定(SFT0203)

POST

/open/api/gateway.do

自由职业者绑卡

自由职业者银行卡绑定，支持银行卡三要素(姓名+身份证号+银行卡号) 和银行卡四要素认证（姓名+身份证号+银行卡号+预留手机号），认证的银行卡可用于后续自由职业者收款

请求参数

Body 参数application/json

apiCode

string

接口编码：SFT0203

必需

merchantNo

string

商户号

必需

requestNo

string

请求流水

必需

timestamp

string

时间戳

必需

version

string

版本号，固定2.0

必需

sign

string

签名

必需

bizModel

object (PersonBankCardBindModel)

必需

personId

number

自由职业者ID

必需

authType

string

认证类型

必需

默认E3，暂只支持E3，E3:三要素认证(姓名+身份证号+银行卡号) E4:四要素认证(姓名+身份证号+银行卡号+手机号)

bankAcctNo

string

银行卡号

必需

mobileNo

string

预留手机号

可选

E4:四要素认证时，必传

示例

{
    "apiCode": "SFT0203",
    "bizModel": "{\"authType\":\"E3\",\"bankAcctNo\":\"6214861204610608\",\"mobileNo\":\"15814488937\",\"personId\":1417026895717261314}",
    "sign": "oGnSK/bbUVFNdTrU0V82C7h8/cTU9g6fsoXN3/6aO9vJBl++/IqQpZW5XB2oIVmA41rWghnzzUn8UkNyqMlQMJQ8bFnGQ6gUg80AXSPMSX2DdcATGUO74JJcDv8x66PMP78LPodRZM+cV3Qrs93p015IOOFJ5LdVEkQG5ZqjNBs=",
    "requestNo": "b2e08026-e60c-4b02-95da-4387d73ff225",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240111112759"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open/api/gateway.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiCode": "SFT0203",
    "bizModel": "{\"authType\":\"E3\",\"bankAcctNo\":\"6214861204610608\",\"mobileNo\":\"15814488937\",\"personId\":1417026895717261314}",
    "sign": "oGnSK/bbUVFNdTrU0V82C7h8/cTU9g6fsoXN3/6aO9vJBl++/IqQpZW5XB2oIVmA41rWghnzzUn8UkNyqMlQMJQ8bFnGQ6gUg80AXSPMSX2DdcATGUO74JJcDv8x66PMP78LPodRZM+cV3Qrs93p015IOOFJ5LdVEkQG5ZqjNBs=",
    "requestNo": "b2e08026-e60c-4b02-95da-4387d73ff225",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240111112759"
}'

返回响应

🟢200OK

application/json

Body

code

integer

响应码，200:成功

必需

msg

string

响应消息

必需

bindId

number

绑卡ID

必需

bankName

string

银行名称

必需

bankCode

string

银行编码

必需

示例

成功示例异常示例

{
    "code": 200,
    "msg": "成功",
    "bindId": "1417026895717261314",
    "bankName": "招商银行",
    "bankCode": "CMB"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

银行卡列表(SFT0201)

银行卡解绑(SFT0204)