Hipay -- API Reference

中文

English

中文

English

Appearance

2、放款 KYC校验（LoanKYCAdd） ​

2.1、LoanKYCAdd 接口 ​

URL: https://${domain}/api/pay/addUserForKYC

     请将 ${domain} 替换为您的实际服务域名。

请求方式:POST

Content-Type:application/json

接口说明: 本接口用于在发起放款请求前验证并添加贷款 KYC 信息。

请求参数（Body-parameters） ​

字段名类型限制必填说明
mchNostring32true商户号
appIdstring32true应用 ID
accountNoString32true银行帐户
accountNameString256true收款人姓名 （泰文 例：ลำดวนการะพิน）
emailString256true收款人邮箱
bankNameString32true银行代码（参见第 5 项）
userPhoneString32true收款人手机号 （泰国10位 例：0814911416）
taxIdString32true收款人身份证号
signString256true签名
reqTimeInt11true请求时间戳（秒）

请求示例（Request-example） ​

js
{
    "mchNo": "M1735112701",
    "appId": "676bb7fefb715596544e2210",
    "accountNo": "1234567890",
    "accountName": "ลำดวนการะพิน",
    "email": "test@gmail.com",
    "bankName": "001",
    "userPhone": "0814911416",
    "taxId": "1234567890123",
    "sign": "B5C3EC55B093C9DE54EBB1199D0FFE7D",
    "reqTime": "1739413509"
}

2.2、LoanKYCAdd 结果 ​

response format:Content-Type:application/json

响应字段（Response-fields） ​

字段名类型说明
codeInt调用结果：0 表示成功（success），其余表示失败（error）
dataObject包含具体数据信息
msgstring结果描述
signstring签名，用于验证数据完整性和真实性

data 对象字段 ​

字段名类型说明
namestring收款人姓名 （泰文 例：ลำดวนการะพิน）
bankAccountstring银行帐户
taxIdLong用户身份证号
bankstring银行名称
statusString状态：Pending/Active/Failed
telNumberstring收款人手机号 （泰国10位 例：0814911416）

响应示例（Response-example） ​

js
{
    "code": 0,
    "data": {
        "data": {
            "bank": "SCB",
            "bankAccount": "1681239123",
            "dateCreated": "17/10/2025 14:34:46",
            "dateModified": "17/10/2025 14:34:46",
            "id": "336481",
            "name": "ลำดวนการะพิน",
            "receiverType": "Individual",
            "relationship": "DefaultValue",
            "status": "Pending/Active/Failed",
            "taxId": "18238219131",
            "telNumber": "0814911416"
        },
        "message": "Success",
        "status": "200"
    },
    "msg": "SUCCESS",
    "sign": "D6C8FCCB187CE946347B36B2CD8E4857"
}

TIP

• 严格放款流程（重点要求）：

（1）必须遵循：先调用 KYC校验接口，再调用放款接口。

（2）姓名格式规范：必须为纯泰文，无空格，不能含有特殊字符。

（3）用户资料真实性：必须提供用户的真实姓名、手机号、邮箱等。缺失或虚假资料将导致还款失败。

（4）不支持批量KYC校验/放款操作，如有违规批量放款行为，账户将被关停。

• 放款KYC 状态要求：

（1）状态：只有 KYC 返回 "Active" 状态时，才能进行放款。

（2）限制：KYC 接口不宜频繁调用，查询状态间隔 10 分钟（银行有保护机制）。

（3）校验说明：KYC 为银行端校验，非通道侧校验，系统不提供 KYC 接口。

• 接收到响应后，请务必验证 sign 字段，以确保数据未被篡改。

• 根据 state 的值确定当前订单的状态，并进行相应的业务逻辑处理。

• 建议使用 HTTPS 协议以保证数据传输安全。

• 银行账户说明：所指银行账户并非用户的银行卡号，请参考以下示例：

img.png