数据模型 - 收款人

收款人概述

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

数据模型结构

参数	类型	描述
name	String	收款人全名，用于交易识别 格式：UTF-8编码字符串 用途：大多数地区必需，用于交易记录和收款人验证 示例："John Doe"、"Maria Rodriguez Lopez"
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、CC
identity	String	身份文档号码 格式：字母数字字符串 用途：必须匹配指定的idType格式，用于收款人验证 示例："12345678909"、"48982488880"
taxNumber	String	税务识别号码 格式：字母数字字符串 用途：巴西付款交易必需，用于税务合规 示例："0123456789"、"12345678988"

地区要求

巴西付款要求

• 必需字段: taxNumber
• 可选字段: 所有其他字段
• 目的: 税务合规和监管要求

秘鲁付款要求

• 必需字段: name、idType、identity、email、phone
• 可选字段: address、taxNumber
• 身份类型: DNI（身份证）、CE（外国人身份证）、PAS（护照）、RUC（税务ID）

哥伦比亚付款要求

• 必需字段: name、idType、identity、email、phone
• 可选字段: address、taxNumber
• 身份类型: CC（国内文档）、CE（外国人文档）

智利付款要求

• 必需字段: name、idType、identity、email、phone
• 可选字段: address、taxNumber
• 身份类型: DNI、CE、PAS、RUT

印度付款要求

• 必需字段: name
• 可选字段: 所有其他字段
• 目的: 基本收款人识别

菲律宾付款要求

• 必需字段: name
• 可选字段: 所有其他字段
• 目的: 基本收款人识别

实现示例

{
  "taxNumber": "0123456789"
}

{
  "name": "Rajesh Kumar"
}

{
  "email": "[email protected]",
  "idType": "DNI",
  "identity": "12345678909",
  "name": "Carlos Rodriguez Mendoza",
  "phone": "51987654321"
}

{
  "email": "[email protected]",
  "idType": "CC",
  "identity": "12345678909",
  "name": "Maria Rodriguez Lopez",
  "phone": "3001234567"
}

{
  "email": "[email protected]",
  "idType": "DNI",
  "identity": "12345678909",