跳转到主要内容

​
什么是用户？

KillB 中的用户代表可以执行 ramp 交易的个人或企业实体。用户在交易前必须完成了解您的客户（KYC）或了解您的业务（KYB）验证。
KillB 中的每笔交易都必须与已验证的用户关联，以符合监管要求。

​
用户类型

个人用户（自然人）必需信息：
  • 全名（名、中、姓）
  • 出生日期
  • 电子邮件和电话
  • 物理地址
  • 政府颁发的 ID
  • 国籍和公民身份
用例：
  • 个人汇款
  • 个人投资
  • 个人加密货币购买
示例：
{
  "type": "PERSON",
  "data": {
    "firstName": "Juan",
    "lastName": "García",
    "dateOfBirth": "1990-05-15",
    "email": "[email protected]",
    "phone": "+573001234567",
    "document": {
      "type": "NUIP",
      "number": "1234567890",
      "issuedCountryCode": "CO"
    }
  }
}

​
用户状态

用户可以有不同的状态：
状态描述可以交易？
ACTIVE用户已验证并批准✅ 是
PENDINGKYC 文档正在审查中❌ 否
REJECTEDKYC 验证失败❌ 否
所有操作都应以 status === ACTIVE 为准。如果用户为 PENDING，请将其引导到 complianceUrl 完成验证。

​
必需文档

​
个人文档

  • NUIP (Número Único de Identificación Personal)
  • Cédula de Ciudadanía (CC)
  • 护照
  • 驾照

​
公司文档

  • NIT（哥伦比亚）- 税务识别号码
  • RFC（墨西哥）- 联邦纳税人登记
  • EIN（美国）- 雇主识别号码
  • CNPJ（巴西）- 法人实体国家登记
  • CUIT（阿根廷）- 唯一税务识别代码

​
外部 ID

externalId 字段允许您将 KillB 用户链接到您自己的用户系统： 
{
  "type": "PERSON",
  "externalId": "user_abc123_from_my_system",
  "data": { ... }
}
优势：
  • 将 KillB 用户映射到您的数据库
  • 避免重复创建用户
  • 简化用户查找
  • 保持引用完整性
使用您的内部用户 ID 作为 externalId，以便在系统之间轻松映射。

​
用户属性

​
核心字段

字段类型必需描述
idUUID自动KillB 生成的用户 ID
typeEnum✅PERSON 或 COMPANY
statusEnum自动ACTIVE、PENDING、REJECTED
customerIdUUID自动您的客户 ID
externalIdString可选您系统的用户 ID
complianceUrlURL自动KYC 验证门户

​
个人特定字段

  • firstName、middleName、lastName
  • dateOfBirth
  • nationality、citizenship
  • employmentStatus、occupation
  • employerName、employmentDescription

​
公司特定字段

  • companyName、tradeName
  • registeredNumber
  • legalStructure（LLC、C_CORP、S_CORP 等）
  • establishedOn
  • naics、naicsDescription
  • mainOwnerUser、ownerUsers[]

​
投资档案

用户必须提供投资档案以符合合规要求： 
{
  "investmentProfile": {
    "primarySourceOfFunds": "EMPLOYMENT",
    "primarySourceOfFundsDescription": "Software engineer salary",
    "totalAssets": "TEN_TO_100K",
    "usdValueOfFiat": "TEN_TO_100K",
    "monthlyDeposits": "UPTO_5",
    "monthlyWithdrawals": "UPTO_5",
    "monthlyInvestmentDeposit": "ONE_TO_100K",
    "monthlyInvestmentWithdrawal": "UPTO_1K",
    "usdValueOfCrypto": "TEN_TO_100K",
    "monthlyCryptoDeposits": "UPTO_5",
    "monthlyCryptoWithdrawals": "UPTO_5"
  }
}

​
资金来源选项

  • EMPLOYMENT - 工资/薪水
  • SAVINGS - 个人储蓄
  • INVESTMENT - 投资收益
  • COMPANY - 业务收入
  • REAL_ESTATE - 房地产收入
  • TRUST - 信托基金
  • OTHER - 其他来源

​
KYC 档案

反洗钱和合规信息： 
{
  "kycProfile": {
    "fundsSendReceiveJurisdictions": ["CO", "US", "MX"],
    "engageInActivities": ["NONE"]
  }
}

​
禁止活动

用户必须确认他们不从事：
  • ADULT_ENTERTAINMENT
  • DRUGS
  • FIREARMS
  • GAMBLING
  • MARIJUANA
  • TUMBLING（加密货币混合）

​
管理用户

​
创建用户

POST /api/v2/users
查看创建用户指南了解详细示例。

​
查询用户

GET /api/v2/users?type=PERSON&email=[email protected]
过滤选项：
  • type - PERSON 或 COMPANY
  • firstName、lastName、email
  • externalId - 您的系统 ID
  • customerId - 按客户过滤

​
更新用户

PATCH /api/v2/users/{userId}
更新用户信息、上传额外文档或修改档案数据。

​
删除用户

DELETE /api/v2/users/{userId}
用户删除是软删除。用户数据为合规目的而保留，但标记为非活动。

​
最佳实践

  • 在提交前验证数据格式
  • 确保姓名与政府 ID 完全匹配
  • 使用正确的电话号码格式（+[国家代码][号码]）
  • 验证电子邮件地址
  • 确认地址完整且准确
  • 始终提供 externalId
  • 使用您的内部用户 ID
  • 实现轻松查找和对账
  • 防止重复创建用户
  • 在允许交易前检查 status
  • 引导用户进行下一步验证
  • 监控 complianceUrl 以获取 KYC 更新
  • 在您的数据库中存储 KillB userId
  • 映射到您的 externalId
  • 适当缓存用户数据
  • 通过 webhooks 同步状态更改

​
常见问题

不可以。每个独特的个人应该只有一个用户配置文件。对所有交易使用相同的用户 ID。
通常从几分钟到 24 小时不等，具体取决于提交信息的完整性以及是否需要人工审查。
可以，使用 PATCH /api/v2/users/{id} 端点。某些字段需要重新验证。
用户状态变为 REJECTED，他们无法交易。检查 note 字段了解拒绝原因。用户可以重新提交更正后的信息。

​
下一步

创建您的第一个用户

遵循分步指南创建用户

了解账户

了解银行账户和钱包

API 参考

查看完整的用户 API 文档