action velopayments_create_payee_v3 {
  label: "Initiate Payee Creation"
  description: "<p>Use v4 instead</p>\nInitiate the process of creating 1 to 2000 payees in a batch Use the response location header to query\nfor status (201 - Created, 400 - invalid request body. In addition to standard semantic validations, a\n400 will also result if there is a duplicate remote id within the batch / if there is a duplicate email\nwithin the batch, i.e. if there is a conflict between the data provided for one payee within the batch and\nthat provided for another payee within the same batch). The validation at this stage is intra-batch only.\nValidation against payees who have already been invited occurs subsequently during processing of the batch.\n"
  provider: velopayments
  method: POST
  path: "/v3/payees"
  encoding: json
  input: {
    type: "object"
    required: ["payees", "payorId"]
    properties: {
      payees: {
        type: "array"
        items: {
          type: "object"
          required: ["address", "email", "remoteId", "type"]
          properties: {
            address: {
              type: "object"
              required: ["city", "country", "line1"]
              properties: {
                city: {
                  type: "string"
                }
                country: {
                  type: "string"
                  description: "2 letter ISO 3166-1 country code"
                }
                countyOrProvince: {
                  type: "string"
                }
                line1: {
                  type: "string"
                }
                line2: {
                  type: "string"
                }
                line3: {
                  type: "string"
                }
                line4: {
                  type: "string"
                }
                zipOrPostcode: {
                  type: "string"
                }
              }
            }
            challenge: {
              type: "object"
              required: ["description", "value"]
              properties: {
                description: {
                  type: "string"
                }
                value: {
                  type: "string"
                }
              }
            }
            company: {
              type: "object"
              required: ["name"]
              properties: {
                name: {
                  type: "string"
                }
                operatingName: {
                  type: "string"
                }
                taxId: {
                  type: "string"
                  description: "Company Tax Id must be between 6 and 30 characters long"
                }
              }
            }
            email: {
              type: "string"
              format: "email"
            }
            individual: {
              type: "object"
              required: ["dateOfBirth", "name"]
              properties: {
                dateOfBirth: {
                  type: "string"
                  format: "date"
                  description: "Must not be date in future. Example - 1970-05-20"
                }
                name: {
                  required: ["firstName", "lastName"]
                  properties: {
                    firstName: {
                      type: "string"
                    }
                    lastName: {
                      type: "string"
                    }
                    otherNames: {
                      type: "string"
                    }
                    title: {
                      type: "string"
                    }
                  }
                }
                nationalIdentification: {
                  type: "string"
                }
              }
            }
            language: {
              type: "string"
              description: "An IETF BCP 47 language code which has been configured for use within this Velo environment.<BR>\nSee the /v1/supportedLanguages endpoint to list the available codes for an environment.\n"
            }
            payeeId: {
              type: "string"
              format: "uuid"
            }
            paymentChannel: {
              type: "object"
              required: ["accountName", "countryCode", "currency"]
              properties: {
                accountName: {
                  type: "string"
                }
                accountNumber: {
                  type: "string"
                  description: "Either routing number and account number or only iban must be set"
                }
                countryCode: {
                  type: "string"
                  description: "Valid ISO 3166 2 character country code. See the <a href=\"https://www.iso.org/iso-3166-country-codes.html\" target=\"_blank\" a>ISO specification</a> for details."
                }
                currency: {
                  type: "string"
                  description: "Valid ISO 4217 3 letter currency code. See the <a href=\"https://www.iso.org/iso-4217-currency-codes.html\" target=\"_blank\" a>ISO specification</a> for details."
                }
                iban: {
                  type: "string"
                  description: "Must match the regular expression ```^[A-Za-z0-9]+$```."
                }
                paymentChannelName: {
                  type: "string"
                }
                routingNumber: {
                  type: "string"
                  description: "Either routing number and account number or only iban must be set"
                }
              }
            }
            payorRefs: {
              type: "array"
              items: {
                type: "object"
                properties: {
                  invitationStatus: {
                    type: "string"
                  }
                  invitationStatusTimestamp: {
                    type: "string"
                    format: "date-time"
                    description: "The timestamp when the invitation status is updated"
                  }
                  payableIssues: {
                    type: "array"
                    description: "Indicates any conditions which prevent the payee from being payable for this payor"
                    items: {
                      type: "object"
                      description: "payable issues for the payee and payor combination"
                      required: ["code", "message"]
                      properties: {
                        code: {
                          type: "string"
                        }
                        message: {
                          type: "string"
                        }
                      }
                    }
                  }
                  payableStatus: {
                    type: "boolean"
                    description: "Indicates if the payee is payable for this payor"
                  }
                  paymentChannelId: {
                    type: "string"
                    format: "uuid"
                  }
                  payorId: {
                    type: "string"
                    format: "uuid"
                  }
                  remoteId: {
                    type: "string"
                  }
                }
              }
            }
            remoteId: {
              type: "string"
            }
            type: {
              type: "string"
              description: "Type of Payee. One of the following values: Individual, Company"
            }
          }
        }
      }
      payorId: {
        type: "string"
      }
    }
  }
  output: {
    type: "object"
    properties: {
      batchId: {
        type: "string"
        format: "uuid"
      }
      rejectedCsvRows: {
        type: "array"
        items: {
          properties: {
            lineNumber: {
              type: "integer"
            }
            message: {
              type: "string"
            }
            rejectedContent: {
              type: "string"
            }
          }
        }
      }
    }
  }
}