数据模型 - 付款人

付款人概述

付款人数据模型定义了收款交易中客户信息的结构。此模型封装了客户识别、联系信息和地区合规要求。

数据模型结构

参数	类型	描述
name	String	客户全名，用于交易识别 格式：UTF-8编码字符串 用途：大多数地区必需，用于交易记录和客户验证 示例："John Doe"、"Carlos Rodriguez Mendoza"
email	String	客户电子邮件地址，用于通知 格式：有效的电子邮件地址 用途：交易通知、支付确认和通信 示例："[email protected]"、"[email protected]"
phone	String	客户电话号码，用于联系目的 格式：国际电话号码格式 用途：交易验证、支持通信和短信通知 示例："62895359978010"、"51987654321"
address	String	客户物理地址 格式：UTF-8编码字符串 用途：大多数交易可选，用于合规和验证 示例："123 Main Street, City, Country"
idType	String	身份文档类型规范 格式：预定义身份类型代码 用途：因地区而异，用于身份验证和合规 示例：DNI、CE、PAS、RUC
identity	String	身份文档号码 格式：字母数字字符串 用途：必须匹配指定的idType格式，用于客户验证 示例："0123456789"、"48982488880"
accountNo	String	银行账户号码，用于转账 格式：字母数字字符串 用途：泰国银行转账必需，用于账户识别 示例："0123456789"、"2345678912"
bankName	String	银行名称，用于账户识别 格式：UTF-8编码字符串 用途：泰国交易推荐，用于银行验证 示例："KBANK"、"BRI"、"BCP"
pixAccount	String	巴西PIX账户标识符 格式：字母数字字符串 用途：巴西PIX交易必需，用于支付处理 示例："0123456789"、"12345678988"

地区要求

印尼收款要求

• OVO支付: phone必需
• 其他方式: 因支付方式而异
• 目的: 移动支付验证和通知

泰国收款要求

• 必需字段: name、accountNo
• 推荐字段: bankName
• 目的: 银行转账识别和验证

巴西收款要求

• 必需字段: pixAccount
• 可选字段: 所有其他字段
• 目的: PIX支付处理和识别

秘鲁收款要求

• 必需字段: name
• 可选字段: 所有其他字段
• 目的: 基本客户识别

哥伦比亚收款要求

• 必需字段: name
• 可选字段: 所有其他字段
• 目的: 基本客户识别

菲律宾收款要求

• 必需字段: name、email、phone
• 可选字段: 所有其他字段
• 目的: 客户识别和通信

实现示例

{
  "phone": "62895359978010"
}

{
  "name": "Somchai Srisai",
  "accountNo": "0123456789",
  "bankName": "KBANK"
}

{
  "pixAccount": "0123456789"
}

{
  "name": "Carlos Rodriguez Mendoza"
}

{
  "name": "Juan Carlos Rodriguez"
}

{