# 打款方新增

> 创建可用于后续 Transfer 打款的打款方。

```yaml
openapi: 3.1.0
info:
  title: 打款方新增
  version: 1.0.0
  description: 创建可用于后续 Transfer 打款的打款方。
paths:
  /api/v1/acct/addPayer:
    post:
      summary: 打款方新增
      description: 创建可用于后续 Transfer 打款的打款方。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号。通常在沙盒或生产商户开通后，从商户后台或开户材料中获取。
                subEntityType:
                  type: string
                  description: 付款主体类型；`0` 表示企业，`1` 表示个人。该选择会决定后续需要补齐企业还是个人主体字段。
                country:
                  type: string
                  description: 付款方国家。
                companyNameEn:
                  type: string
                  description: 企业付款方的英文公司名称。
                companyName:
                  type: string
                  description: 企业付款方的本地公司名称。
                addressEn1:
                  type: string
                  description: 付款方地址第一行。
                postcode:
                  type: string
                  description: 付款方邮编。
                email:
                  type: string
                  description: 付款方邮箱。
                areaCode:
                  type: string
                  description: 电话号码区号。
                phoneNumber:
                  type: string
                  description: 付款方手机号。
                state:
                  type: string
                  description: 付款方省州。
                city:
                  type: string
                  description: 付款方城市。
                idType:
                  type: string
                  description: 付款方证件类型。具体取值取决于付款方是企业还是个人。
                idNumber:
                  type: string
                  description: 付款方证件号码。
                idValidDateTo:
                  type: string
                  description: 付款方证件到期日。
                sign:
                  type: string
                  description: 请求签名字符串，需使用商户私钥按 Transfer 请求签名规则生成。
              required:
                - merchantNo
                - subEntityType
                - country
                - addressEn1
                - postcode
                - email
                - areaCode
                - phoneNumber
                - state
                - city
                - idType
                - idNumber
                - idValidDateTo
                - sign
            examples:
              create-business-payer:
                summary: 创建企业付款方
                value:
                  addressEn1: Nanshan Science & Technology Park, Shenzhen
                  areaCode: "+86"
                  city: London
                  companyName: Demo Company Ltd
                  companyNameEn: Demo Company Ltd
                  country: GB
                  email: payer@example.com
                  idNumber: "4563456546"
                  idType: "2"
                  idValidDateTo: 2046-08-04
                  merchantNo: "801129"
                  phoneNumber: "15072871023"
                  postcode: "518057"
                  sign: "{{SIGN}}"
                  state: London
                  subEntityType: "0"
      responses:
        "200":
          description: 付款方创建成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: Onerway 返回的响应码。
                  respMsg:
                    type:
                      - string
                      - "null"
                    description: Onerway 返回的响应信息。
                    x-onerway-value:
                      nullable: true
                      when:
                        en: No response message is returned.
                        zh: 未返回响应信息时为 `null`。
                  data:
                    type: string
                    description: 成功创建后返回的付款方 ID。
              examples:
                payer-created:
                  summary: 付款方创建成功
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data: "1984096429476806656"
```