Sign in
Payors

Get Payor

Get a Single Payor by Id.

get/v2/payors/{payorId}

Path parameters

payorIdstring uuid required

The Payor Id

Response

Get Payor Details

payorIdstring uuid required
payorNamestring required

The name of the payor.

payorXidstring

A unique identifier that an external system uses to reference the payor in their system

providerstring

The source of the payorXid, default is null which means Velo

primaryContactNamestring

Name of primary contact for the payor.

primaryContactPhonestring

Primary contact phone number for the payor.

primaryContactEmailstring email

Primary contact email for the payor.

kycStatestring

The kyc state of the payor. One of the following values: FAILED_KYC, PASSED_KYC, REQUIRES_KYC

manualLockoutboolean

Whether or not the payor has been manually locked by the backoffice.

openBankingEnabledboolean

Is Open Banking supported for this payor

payeeGracePeriodProcessingEnabledboolean

Whether grace period processing is enabled.

payeeGracePeriodDaysinteger

The grace period for paying payees in days.

collectiveAliasstring

How the payor has chosen to refer to payees.

supportContactstring

The payor’s support contact email address.

dbaNamestring

The payor’s 'Doing Business As' name.

allowsLanguageChoiceboolean

Whether or not the payor allows language choice in the UI.

reminderEmailsOptOutboolean

Whether or not the payor has opted-out of reminder emails being sent.

languagestring

The payor’s language preference. Must be one of [EN, FR]

includesReportsboolean
wuCustomerIdstring
maxMasterPayorAdminsinteger
paymentRailsstring

The id of the payment rails

remoteSystemIdsstring[]

The payor’s supported remote systems by id

usdTxnValueReportingThresholdinteger

USD in minor units

managingPayeesboolean

Example response

{
  "primaryContactName": "Joe Buck",
  "payeeGracePeriodProcessingEnabled": true,
  "supportContact": "support@example.com",
  "payorXid": "ABC_201234",
  "includesReports": true,
  "managingPayees": true,
  "allowsLanguageChoice": true,
  "language": "EN",
  "provider": "provider",
  "maxMasterPayorAdmins": 6,
  "transmissionTypes": {
    "ACH": true,
    "SAME_DAY_ACH": true,
    "WIRE": true
  },
  "manualLockout": true,
  "paymentRails": "paymentRails",
  "payorId": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "primaryContactEmail": "joe.buck@example.com",
  "usdTxnValueReportingThreshold": 1000000,
  "payorName": "Example, Corp",
  "address": {
    "country": "US",
    "countyOrProvince": "FL",
    "line4": "line4",
    "city": "Key West",
    "line3": "line3",
    "line2": "line2",
    "line1": "500 Duval St",
    "zipOrPostcode": "33945"
  },
  "openBankingEnabled": true,
  "dbaName": "Some Biz",
  "primaryContactPhone": "123-123-1234",
  "payeeGracePeriodDays": 0,
  "reminderEmailsOptOut": true,
  "collectiveAlias": "Payee",
  "kycState": "PASSED_KYC",
  "wuCustomerId": "wuCustomerId",
  "remoteSystemIds": [
    "REMOTE_SYSTEM_ID",
    "REMOTE_SYSTEM_ID"
  ]
}

Changes