CreatePayoutRequest

typePayoutType (string)required

下发单类型：

• INTERNATIONAL_TRANSFER — 国际汇款（SWIFT）
• CHINA_MAINLAND_BANK_TRANSFER — 中国大陆银行转账
• ALIPAY_MAINLAND_TRANSFER — 中国大陆支付宝转账

Possible values: [INTERNATIONAL_TRANSFER, CHINA_MAINLAND_BANK_TRANSFER, ALIPAY_MAINLAND_TRANSFER]

payout_details objectrequired

request objectrequired

sourceCurrencystring

付款货币代码

Example: USD

destinationCurrencystring

收款货币代码

Example: CNY

notesstring

备注信息

Example: Q1 供应商款项

remits object[]required

汇款明细列表，至少包含一条

Possible values: >= 1

Array [

typeRemitType (string)required

汇款明细类型：

• SWIFT — 国际汇款
• CHINA_MAINLAND_BANK — 中国大陆银行转账
• ALIPAY_MAINLAND — 中国大陆支付宝转账

Possible values: [SWIFT, CHINA_MAINLAND_BANK, ALIPAY_MAINLAND]

line_numberintegerrequired

明细行号，从 1 开始递增

Possible values: >= 1

Example: 1

details objectrequired

amount object

receive_amountnumber

收款金额

Example: 10000

recipient object

收款方信息（与 recipient_id 二选一）

oneOf

• SWIFTRecipient
• ChinaMainlandBankRecipient
• AlipayMainlandRecipient

account_typeAccountType (string)required

账户类型：

• PERSONAL — 个人账户
• COMPANY — 公司/企业账户

Possible values: [PERSONAL, COMPANY]

country_codestringrequired

ISO 3166-1 Alpha-3 国家代码

Possible values: >= 3 characters and <= 3 characters

Example: CHN

transfer_typeTransferType (string)required

汇款方式（仅 SWIFT）：

• WIRE — 普通汇款
• WIRE_SAME_NAME — 同名汇款

Possible values: [WIRE, WIRE_SAME_NAME]

bank_namestringrequired

银行名称

Example: China Construction Bank

bank_swift_codestringrequired

SWIFT/BIC 代码

Example: PCBCCNBJ

bank_addressstringrequired

银行地址

Example: Beijing, China

intermediary_bank_swift_codestring

中间行 SWIFT 代码（可选）

account_numberstringrequired

收款账号

Example: 6217001234567890

beneficiary_namestringrequired

收款人姓名

Example: Example Corp Ltd

beneficiary_id_documentstring[]

身份证件文件 ID（同名汇款 + 个人账户时必填）

Possible values: <= 3

beneficiary_statementstring[]

声明文件 ID（同名汇款 + 个人账户时必填）

Possible values: <= 3

beneficiary_business_registrationstring[]

营业执照文件 ID（公司账户时必填）

Possible values: <= 3

beneficiary_company_registrationstring[]

公司注册文件 ID（公司账户时必填）

Possible values: <= 3

recipient_idstring<uuid>

已有收款方 ID（与 recipient 二选一）

payee_idstring<uuid>

已有收款人 ID

display_namestring

收款方显示名称

Example: 供应商A

save_as_payeeboolean

是否保存为收款人，默认 false

Default value: false

]

CreatePayoutRequest

{
  "type": "INTERNATIONAL_TRANSFER",
  "payout_details": {
    "request": {
      "sourceCurrency": "USD",
      "destinationCurrency": "CNY",
      "notes": "Q1 供应商款项"
    }
  },
  "remits": [
    {
      "type": "SWIFT",
      "line_number": 1,
      "details": {
        "amount": {
          "receive_amount": 10000
        },
        "recipient": {
          "account_type": "PERSONAL",
          "country_code": "CHN",
          "transfer_type": "WIRE",
          "bank_name": "China Construction Bank",
          "bank_swift_code": "PCBCCNBJ",
          "bank_address": "Beijing, China",
          "intermediary_bank_swift_code": "string",
          "account_number": "6217001234567890",
          "beneficiary_name": "Example Corp Ltd",
          "beneficiary_id_document": [
            "string"
          ],
          "beneficiary_statement": [
            "string"
          ],
          "beneficiary_business_registration": [
            "string"
          ],
          "beneficiary_company_registration": [
            "string"
          ]
        },
        "recipient_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "payee_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "display_name": "供应商A",
        "save_as_payee": false
      }
    }
  ]
}