# 打款方编辑

> 更新已有打款方资料。

```yaml
openapi: 3.1.0
info:
  title: 打款方编辑
  version: 1.0.0
  description: 更新已有打款方资料。
paths:
  /api/v1/acct/editPayer:
    post:
      summary: 打款方编辑
      description: 更新已有打款方资料。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                  description: 需要更新的付款方 ID。
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号。通常在沙盒或生产商户开通后，从商户后台或开户材料中获取。
                companyNameEn:
                  type: string
                  description: 企业付款方的英文公司名称。
                companyName:
                  type: string
                  description: 企业付款方的本地公司名称。
                country:
                  type: string
                  description: 付款方国家。
                addressEn1:
                  type: string
                  description: 付款方地址第一行。
                addressEn2:
                  type: string
                  description: 付款方地址第二行。
                addressEn3:
                  type: string
                  description: 付款方地址第三行。
                registerNo:
                  type: string
                  description: 注册号。
                registerDate:
                  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: 城市。
                subEntityType:
                  type: string
                  description: 打款主体类型。
                firstName:
                  type: string
                  description: 个人付款方的名字。
                lastName:
                  type: string
                  description: 个人付款方的姓氏。
                idType:
                  type: string
                  description: 证件类型。
                idNumber:
                  type: string
                  description: 证件号码。
                birthDate:
                  type: string
                  description: 个人付款方的出生日期。
                idValidDateFrom:
                  type: string
                  description: 证件生效日期。
                idValidDateTo:
                  type: string
                  description: 证件到期日。
                sign:
                  type: string
                  description: 请求签名字符串，需使用商户私钥按 Transfer 请求签名规则生成。
              required:
                - id
                - merchantNo
                - country
                - addressEn1
                - postcode
                - email
                - areaCode
                - phoneNumber
                - state
                - city
                - idType
                - idNumber
                - idValidDateTo
                - sign
            examples:
              update-payer:
                summary: 付款方编辑请求示例
                value:
                  addressEn1: Nanshan Science & Technology Park, Shenzhen
                  addressEn2: 2all
                  addressEn3: "3"
                  areaCode: "+86"
                  city: London
                  companyName: 卡玛有限公司 &sunshine
                  companyNameEn: keyma LTD.
                  country: GB
                  email: 324321@qq.com
                  id: 1984096429476806700
                  idType: "2"
                  idValidDateFrom: 2006-08-04
                  idValidDateTo: 2046-08-04
                  merchantNo: 801129
                  phoneNumber: "15072871023"
                  postcode: "518057"
                  registerDate: 2005-08-04
                  registerNo: "4563456546"
                  sign: d2ea92efff636320122021f65b613201403f6d34334cfbc7e589ce9f842282q4
                  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:
                      - object
                      - "null"
                    properties:
                      {}
                    description: 更新结果占位数据。
                    x-onerway-value:
                      nullable: true
                      when:
                        en: The API may return `null` for a successful update result.
                        zh: 接口在更新成功时可能返回 `null`。
              examples:
                payer-updated:
                  summary: 付款方编辑响应示例
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data: null
```