AFT 参数

当业务场景涉及资金划转时，创建 Payment Intent 需要额外传入 AFT（Account Funding Transaction）相关参数。以下是这些参数的说明。

参数说明

下列所有字段都属于 recipient_sender_details 对象。

对象	字段	类型	约束	说明
(root)	`fund_source`	String	必填。取值：`01`、`02`、`03`、`04`、`05`、`06`、`25`	资金来源代码： `01`：信用卡 `02`：借记卡 `03`：预付卡 `04`：现金 `05`：借记 / 存款账户 `06`：信用账户 `25`：移动支付账户
recipient	`first_name`	String	必填。 `^[a-zA-Z0-9 \-]{1,30}$`	收款人（主账户持有人）的名。
	`last_name`	String	必填。 `^[a-zA-Z0-9 \-]{1,30}$`	收款人的姓。
	`birth`	String	必填。必须为 YYYYMMDD 格式的 8 位数字	收款人出生日期。
	`account_number`	String	必填。 `^[a-zA-Z0-9*]{8}$`	收款人的 PAN 或账号。
	`postcode`	String	必填。 `^[a-zA-Z0-9 /\-]{1,10}$`	收款人邮编。
	`street`	String	必填。 `^['"0-9A-Za-z]{1,30}$`	收款人详细地址。
	`city`	String	必填。 `^['"0-9A-Za-z]{1,25}$`	收款人所在城市。
	`state`	String	当 `country_code` 为 `CAN`/`USA`/`COL`/`NIC` 时必填。 `^[0-9A-Za-z]{2,3}$`	收款人所在州 / 省代码。
	`country_code`	String	必填。 `^[A-Z]{3}$`。必须是有效的 ISO 国家代码	收款人国家代码（ISO 3166-1 alpha-2/3）。
sender	`first_name`	String	必填。最大长度：30 个字符	发送人（付款人）的名。
	`last_name`	String	必填。最大长度：6 个字符	发送人的姓。
	`birth`	String	必填。必须为 YYYYMMDD 格式的 8 位数字	发送人出生日期。
	`street`	String	必填。最大长度：30 个字符	发送人详细地址。
	`city`	String	必填。最大长度：25 个字符	发送人所在城市。
	`state`	String	当 `country_code` 为 `CAN`/`USA`/`COL`/`NIC` 时必填。长度：2~3 个字符	发送人所在州 / 省代码。
	`country_code`	String	必填。最大长度：3 个字符。必须是有效的 ISO 国家代码	发送人国家代码（ISO 3166-1 alpha-2/3）。

截取规则

如果字段值超过设定的长度上限，可以进行截取。此规则主要适用于地址相关字段，如 street、state 和 city。姓名字段通常不会超过上限，但在极少数情况下也可以截取。若对姓名字段进行了截取，请确保同一个人在所有记录中的截取结果保持一致。

JSON 示例

{
  "recipient_sender_details": {
    "fund_source": "01",
    "recipient": {
      "first_name": "John",
      "last_name": "Doe",
      "birth": "19900101",
      "account_number": "12345678",
      "postcode": "123456",
      "street": "123 Main Street",
      "city": "Singapore",
      "state": "01",
      "country_code": "SG"
    },
    "sender": {
      "first_name": "Jane",
      "last_name": "Smith",
      "birth": "19950505",
      "street": "456 Orchard Road",
      "city": "Singapore",
      "state": "03",
      "country_code": "SG"
    }
  }
}

入门

收款集成

支付管理

测试

参考

参数说明

截取规则

JSON 示例

​参数说明

​截取规则

​JSON 示例

参数说明

截取规则

JSON 示例