创建客户

功能简述

• 创建商户下客户

客户状态说明

创建客户的初始状态为待完善资料，商户完善客户资料后转变为待审核，待审核状态后，系统审核人员可对该数据进行审核成功、审核失败、封禁等操作。

创建客户 API

请求 URL

• /payee/custom/create

请求方式

• POST

请求参数

请求参数如下：

• Header

  • 查看请求/响应头

• Request Body

提示

1. 客户账户信息如果是银行账户 bankcode、cardno、ibanaccount 必填。如果客户账户为 STCPay 账户则 stcaccount 必填。
2. 代付 KWD 或 AED 货币，需要客户信息填写 address 或者 swiftcode。
3. 沙箱环境中可以通过测试账户来模拟客户的审核状态。
4. 发送 OTP 验证的产品名称可以联系系统管理员添加，支持多个产品名称，默认名称为后台公司名称。
5. 当开启自动审批功能，客户新增或更新了 stcaccount，会对客户设置的 stcaccount 自动创建 OTP 发送任务

参数	必填	类型	默认值	描述
name_e	是	string	-	客户英文名称，长度限制 64 字符
name_a	是	string	-	客户阿拉伯文名称，长度限制 64 字符，如果客户无阿拉伯文名称可以填写为客户英文名称
mercustomid	是	string	-	商户客户 ID ，要求商户下唯一，长度限制 128 字符
identity	是	string	-	身份证号（敏感信息，使用系统公钥加密处理），长度限制 64 字符
bankcode	否	string	-	银行 CODE
cardno	否	string	-	银行账户（敏感信息，使用系统公钥加密处理），要求为数字，长度限制 13 ～ 19 字符
ibanaccount	否	string	-	IBAN，字母和数字组成，长度限制 34 字符
stcaccount	否	string	-	STCPay 账户（敏感信息，使用系统公钥加密处理），支持格式： 5xxxxxxxx 9665xxxxxxxx +9665xxxxxxxx 05xxxxxxxx
address	否	string	-	客户银行卡绑定的地址信息，长度限制 255 字符
swiftcode	否	string	-	客户银行账户对应的 Swift Code，长度限制 32 字符
autoapproval	否	number	0	是否开启自动审批： 0：不开启 1：开启
otpappname	否	string	-	发送 OTP 验证的产品名称，需要与后台配置匹配，默认名称为后台公司名称，长度限制 32 字符

请求参数示例

{
  "name_e": "usera",
  "name_a": "usera",
  "mercustomid": "u001",
  "identity": "z9LnjQJuvqDnaWsrLgrO1GxT2z7fww/sxNxWjrMTinFgT5dNrn1CbpRMy99qc1GnyqzlwBytZf6oa4fOQO5kHQwR4DVMRpmii81MqgAuWBQJktCG5mAgd5yzUO2kLZyHDfy5J7Y2pMyqmFzvMPiD1tIxPezgcExXEKxcPKs1tvOr+7zgTbNtnvfm1VW+BzIVmJYmaXBW4ZhEdJqz+dxdSyZIdUdbV1oc46xiuIxZOn3hxYMy0XnGjNJNT9TSW299pSSDBpVbCoWg9u4okMI222adQyikyfz+TlSsVNTHnnB8C+rf+Kjc6ZPszCdu+KTjiYOTkRlJIUbHe0bM02pOjg==",
  "bankcode": "1174c",
  "cardno": "Zh4EkxILOkTNwk4PcEerZjpmmTu6IorKDC1jpm4l3hMuEI4zWJ2pyafiTDNaIoN6VOh8ivWxJBeOD2N6uXiPwJ6qyreVMhDsYa8nHK58l2JM6BC1teG0Q61ZPknXloB6aaDgDSQetbdomggAH+cu7masFnLU+YmI1umP/p7DhePYjT69Yq3vJ2wBEUp0dVIaINB0c4uB/bapmWb3zmBcSW1To2RopXlNIggjk1qdLUtxXmaYdzkyRJbevpBHARaA/BwIm3e1/ZwO+WUETBmhci96ciPBuf/NzyhUp9UHPgNoajdAwwdN5FUEA9E1KE6uwHdWMAICy/pWzsaOjoQpOQ==",
  "ibanaccount": "1234567892"
}

响应参数

响应参数如下：

• Response Body

参数名	类型	描述
customid	string	系统客户 ID
mercustomid	string	商户客户 ID
name_e	string	客户英文名称
name_a	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": "usera",
    "name_a": "usera",
    "address": "Saudi Arabia",
    "identity": "s0YhJVboAqQj8kLCkTqCttAwpP39nR5VaaTy8pWFwSQDjSYei7YqZAbcoeckAD40bgliH9sSXre9PafDDpHfdkKX22X0lvJzIcpL8PGSpWQT2XloHjKxExRhiq/AgzEnwV9kq66b2hqi56O2djjzYOXOz/BpYKqvqWG7ak47OLV2hDR6r0hzhZsdvvvCeo21lMafUGd6hmf6TElqDntIfgFNTGSbxkV3kKlXnNX0hdHPmGtnfqbIuxo+yAHeJdffxA/6iHzSsW92t/bvtB9hV5ON+v4s/VpVZCRYmj0AIs9bQ+Ed+hNXtlmLuyaxfRdYVG6nl1MhVGJG0QioO4sNag==",
    "identitypic": "",
    "signpic": "",
    "bankname": "Riyad Bank",
    "bankcode": "1174c",
    "cardno": "W0jEosfhj/TfHAjjxyIaCWHZVfdwL/2rsXj4xoXzuPWZN2nKLYmlogABKjuNF9930fmyCyt3cGZD4MRgwjf8/ZZKb0HqQLAtw+rfc/2PRViXkdq4vr3iTGyH4W7MW4n0yw6rREZUf+9/R96zyqA5iky0A0kz2suAiKBQjsQGZ1PBCGYPxmzDnpolk76Bhvpm2YNgQnvRCLUQIOCIdq4Aj9rmV0MzfhilTZ3MhIe4WqW7eubFwq0+3CF484uSVemkdRYPVZ17umbCDTRENdzkTKUIZwxTxRTMfHyUr5Sx75RyBpJDzoReluIKnX9tzQ/jb+/V4Eiv39FD4l5/Zp8trA==",
    "ibanaccount": "1234567892",
    "swiftcode": "ABNACNSHXXX",
    "stcaccount": "",
    "status": 4,
    "statusdesc": "2023-06-15 06:12:54",
    "autoapproval": 1,
    "otpappname": "test",
    "demand_perfection": ["identitypic"],
    "created_at": 1686809574,
    "updated_at": 1686809574
  },
  "sensitiveFields": [
    "identity",
    "identitypic",
    "signpic",
    "stcaccount",
    "cardno"
  ],
  "requestId": "91A8340E7AEE8EC99D06EB46DF92A19F"
}