VEvelopaymentsapi
Payee Invitation

Initiate Payee Creation

Changed on

Initiate the process of creating 1 to 2000 payees in a batch

Use the batchId in the response to query for status.

In addition to standard semantic validations, a 400 will also result if:

  • there is a duplicate remote id within the batch
  • there is a duplicate email within the batch, i.e. if there is a conflict between the data provided for one payee within the batch and that provided for another payee within the same batch).

The validation at this stage is intra-batch only.

Validation against payees who have already been invited occurs subsequently during processing of the batch.

post/v4/payees

Request

  • Base URL
    https://api.sandbox.velopayments.com
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://api.sandbox.velopayments.com/v1/login

Request body

payorIdstring required

Example request

{
  "payees": [
    {
      "address": {
        "country": "US",
        "countyOrProvince": "FL",
        "line4": "line4",
        "city": "Key West",
        "line3": "line3",
        "line2": "line2",
        "line1": "500 Duval St",
        "zipOrPostcode": "33945"
      },
      "individual": {
        "name": {
          "firstName": "Bob",
          "lastName": "Smith",
          "otherNames": "H",
          "title": "Mr"
        },
        "nationalIdentification": "SA211123K",
        "dateOfBirth": "1970-05-20T00:00:00.000+0000"
      },
      "challenge": {
        "description": "challenge description",
        "value": "11984567"
      },
      "language": "en-US",
      "company": {
        "taxId": "123123123",
        "name": "ABC Group Plc",
        "operatingName": "ABC Co"
      },
      "email": "bob@example.com",
      "remoteId": "Remote ID",
      "paymentChannel": {
        "paymentChannelName": "My Payment Channel",
        "routingNumber": "XXXXX6789",
        "accountName": "My account",
        "countryCode": "US",
        "iban": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX1234",
        "currency": "USD",
        "accountNumber": "XXXXXX5678"
      }
    },
    {
      "address": {
        "country": "US",
        "countyOrProvince": "FL",
        "line4": "line4",
        "city": "Key West",
        "line3": "line3",
        "line2": "line2",
        "line1": "500 Duval St",
        "zipOrPostcode": "33945"
      },
      "individual": {
        "name": {
          "firstName": "Bob",
          "lastName": "Smith",
          "otherNames": "H",
          "title": "Mr"
        },
        "nationalIdentification": "SA211123K",
        "dateOfBirth": "1970-05-20T00:00:00.000+0000"
      },
      "challenge": {
        "description": "challenge description",
        "value": "11984567"
      },
      "language": "en-US",
      "company": {
        "taxId": "123123123",
        "name": "ABC Group Plc",
        "operatingName": "ABC Co"
      },
      "email": "bob@example.com",
      "remoteId": "Remote ID",
      "paymentChannel": {
        "paymentChannelName": "My Payment Channel",
        "routingNumber": "XXXXX6789",
        "accountName": "My account",
        "countryCode": "US",
        "iban": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX1234",
        "currency": "USD",
        "accountNumber": "XXXXXX5678"
      }
    }
  ],
  "payorId": "9ac75325-5dcd-42d5-b992-175d7e0a035e"
}

Response

HTTP Created. Body created only on CSV requests

batchIdstring uuid

Example response

{
  "batchId": "cb6ff8c6-85e9-45a6-b7d9-d05305db67f3",
  "rejectedCsvRows": [
    {
      "rejectedContent": "unable,to,process,csv,line",
      "lineNumber": 3,
      "message": "rejected message 1"
    },
    {
      "rejectedContent": "unable,to,process,csv,line",
      "lineNumber": 3,
      "message": "rejected message 1"
    }
  ]
}

Changes

  • 05c3f09fc50aRevision changes
    • breaking

      the // request property's maxLength was decreased to 20 (media type: multipart/form-data)

    • breaking

      the /// request property's maxLength was decreased to 20 (media type: application/json)

    • breaking

      the // request property's minLength was increased from 1 to 2 (media type: multipart/form-data)

    • info

      the request property // became optional (media type: multipart/form-data)

    • info

      the // request property's minLength was decreased from 6 to 4 (media type: multipart/form-data)

    • info

      the /// request property's minLength was decreased from 6 to 4 (media type: application/json)

    • info

      the /// request property's minLength was decreased from 6 to 4 (media type: application/json)

  • 1e7a1734a45cRevision changes
    • breaking

      removed the enum value ACCEPTED of the request property //// (media type: application/json)

    • breaking

      removed the enum value DECLINED of the request property //// (media type: application/json)

    • breaking

      removed the enum value EUR of the request property // (media type: multipart/form-data)

    • breaking

      removed the enum value GBP of the request property // (media type: multipart/form-data)

    • breaking

      removed the enum value PENDING of the request property //// (media type: application/json)

    • breaking

      removed the enum value USD of the request property // (media type: multipart/form-data)

    • breaking

      the // request property's minLength was increased from 0 to 3 (media type: multipart/form-data)

    • warning

      the // request property's maxLength was set to 3 (media type: multipart/form-data)