更新客户资料

功能简述

• 更新客户资料

客户状态说明

目前客户强制需要完善的资料为身份证照片。如果客户未被封禁，当客户更新资料后并且已设置身份证照片，客户状态会重置为待审核状态。

注意

1. 如果提交的更新数据与客户现有数据一致，则客户信息保持不变，不做状态转变。
2. 客户资料变更不影响该客户已经创建的代付单，代付单会继续按照创建时的客户信息进行处理。

更新客户资料 API

请求 URL

• /payee/custom/file

请求方式

• POST

请求参数

请求参数如下：

• Header

  • 查看请求/响应头

• Request Body

提示

1. 商户客户 ID 和系统客户 ID 传其中一个，如果都不传接口会响应参数缺失错误。
2. 沙箱环境中可以通过测试账户来模拟客户的审核状态。

参数	必填	类型	默认值	描述
mercustomid	否	string	-	商户客户 ID，长度限制 128 字符
customid	否	string	-	系统客户 ID，长度限制 64 字符
file	是	file	-	文件大小不能超过2048kb，文件必须是图片类型： jpeg png bmp gif svg webp
md5	是	string	-	文件的 MD5 值
type	是	string	-	文件的类型： identitypic: 身份证照片 signpic: 签名照片

响应参数

文件处理成功后，返回最新的客户信息。

响应参数如下：

• Response Body

参数名	类型	描述
customid	string	系统客户 ID
mercustomid	string	商户客户 ID
name_e	string	客户英文名称
name_a	string	客户阿拉伯文名称
mobile	string	客户手机号
address	string	客户银行卡绑定的地址信息
identity	string	身份证号（敏感信息，使用商户公钥加密处理）
identitypic	string	身份证照片 URL（敏感信息，使用商户公钥加密处理）
signpic	string	签名照片 URL（敏感信息，使用商户公钥加密处理）
bankname	string	银行名称
bankcode	string	银行 CODE
cardno	string	银行账户（敏感信息，使用商户公钥加密处理）
ibanaccount	string	IBAN
swiftcode	string	客户银行账户对应的 Swift Code
stcaccount	string	STCPay 账户（敏感信息，使用商户公钥加密处理）
status	number	客户状态
statusdesc	string	客户状态说明
autoapproval	number	是否开启自动审批： 0：不开启 1：开启
otpappname	string	发送 OTP 验证的产品名称
demand_perfection	array	用户当前待完善哪些资料
created_at	number	创建时间
updated_at	number	更新时间

响应参数示例

{
    "code": 200,
    "message": "Request succeeded.",
    "data": {
        "customid": "12ad4",
        "mercustomid": "u004",
        "name_e": "updTest2",
        "name_a": "usera",
        "mobile": "Dl6W1H0FxS/M86t9beRVietvkH2ZwIZNO4AwVJI5BGJfh/hJ83n3oXkfABfYCH/4SgklJVQ7aSqiHQ+8LIbUh5ycjfqTCGRpKgfk5Ae2/9NRsOpcnfl9GMo2oP4AiS4NEdJBybtSm+gDCxRrDqyAIpLq6ycXJT3BGqtKPu1xsqzdYQuJovdERg/8GqKn57r2MI3jXGIhdInL61SNuAFImOTVCBXA0ZXsho0Txtp1zJj+t6raQbCvynNgYHNIqrUh6Kta8mezJGqfLtw0RE7VzgWGFKb3caEzdAZERF3BHx49qR72MvIHtRBpoxfvf9VB9cZf2yn/+yo9iaDqMLxsug==",
        "address": "Saudi Arabia",
        "identity": "NbX4Ex6OsXEujrdo3p3fqKPlI1607Z59xwRIZDwlaHlHtUNLSJCP6Hp9TQVVZt66Pw+7LLENT84l6TiH7owxgY+jUl5qfRs4+ooNb3Hb4tWgXcUBi3f8NDKI3KNL5FdiXXsaqy/l8uWZoiDuRuwfQCZEUJPl3yacVfwgq8IwUO4Gqld9iN6ciyxAT16w/rkafV56gNDaWNrLet8/3HxaCUXmYfs1SpYyUwi3Hn2uI1sDme9MLZtPUo/0Nwbq5MyR5IANq4O6Enw1K3LQ4g9ZmmS7QpY7iFGT/3zKFAsycjD8focAmM9+quITspykDR3p0y9Pvs6PWMXiR5FjhAaRsw==",
        "identitypic": "S6U6BDjYfqgHxJVGfgrRNoK+lMM050wJaxZZJ68k6dnLpyoqETiSbLvjVmmFnfdTnzQRKu3qXAKRe/PJYDq4EgT5G2hS0iS3UtvkHKgjACcDvgPqVIGDpH4ru7UbopZwJNRfrBLlVcV+N+wWMqii/r1t5wTGdx8yupy/3jhZX7hhO8HFl+BvR4JSgdPWNH00zu4sTi/w2P5wEayIzK4ya/Be7w0ULbhFgoczNRrdo9hoIbewH529s74OApked4/U3uaquCjjv6h+m+U/P9efRTsOl+5u/AmYxO4mTI2C+k8SY8lK9JUBI+1wVQm/Sj81UcXAFLN2IjFYo/bbrZuOww==",
        "signpic": "",
        "bankname": "Riyad Bank",
        "bankcode": "1174c",
        "cardno": "ZVanGfGN1gpvxACjCBvDuToQevSAgZbvmksSioWvej4ATnTjp2ytSmdcIkKA3CtkcoiZXTVp11yazyj4JYpQDC99uO+mE13zIz48Uxs98GM8DY+USO3SPCAEn70YyBZ5jX9GfhWob+1UwUkqjh++WOvQbYZl7JxxMLyTG62T4pXo74XWHZeX5kUTTFOJvX8Lc9h3WmVV8GG6xcU+HZ2dWlUO0EZHTIFm7ymre5w1fXUfR9ljHzb7AVYnTIArLENPPFSNYh7HvzZIMloA0exffgcUT4sZwUD5iTeNXDSAjfLRb/n7HDFAlTvZZpxWt0cKNSruPtvyQ5xiptAA3RmEOw==",
        "ibanaccount": "1234567892",
        "swiftcode": "ABNACNSHXXX",
        "stcaccount": "W1pNqEGNzONfUPfixrH61nJsgh8iFI1pv1e0VFo/rNZO6d34fFPwj/SPMqajWRjOFp8IJjBJZWOMbFALS8nTx93lhIJddtEWkNPf3t+qKSlyehORZhF/5RYzvmAu7ThV/124BOzSs/LsX7u8ZKzhudpVU6GWFZr+0GgwzDZNr/SdVm9S2ec621wSuUVgzu3ahINg/7ko5RuVzkK6eUPZ+R/v8xnRowH6SCjKfuNtHONU/7u0si1gryL8D7cb1NYy2yAx7FxWexRFyDendPZB0TsISMwAqV29RSDxG+AfJDvbsfs3mZia352avZmEpxcxILntqncjOdRnVrjEheq8sQ==",
        "status": 0,
        "statusdesc": "2023-06-15 06:14:45",
        "autoapproval": 1,
        "otpappname": "test",
        "demand_perfection": [],
        "created_at": 1686809574,
        "updated_at": 1686809685
    },
    "sensitiveFields": [
        "identity",
        "identitypic",
        "signpic",
        "stcaccount",
        "mobile",
        "cardno"
    ],
    "requestId": "B299710699082B7D5EA8E6C793E74649"
}