Vendor

Update vendor

Updates a vendor's information. Send only the fields you need to update.

put/Vendor/{idVendor}

Request

  • Base URL: https://api-sandbox.payabli.com/api
  • URL: https://api-sandbox.payabli.com/api/Vendor/{idVendor}
  • Auth: HTTP bearer

Path parameters

idVendorinteger required

Vendor ID.

Request body

vendorNumberstring

Custom number identifying the vendor. Must be unique in paypoint. Can't be blank.

AdditionalDataAdditionalDataMap

Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. If you are using custom identifiers, pass those in this object. Max length for a value is 100 characters.

{
  "additionalData": {
    "key1": "value1",
    "key2": "value2",
    "key3": "value3"
  }
}
address1string

The address.

address2string

Additional line for the address.

citystring

Vendor's city. Required if any address field is provided.

countrystring

Vendor's country. Must be US or CA. Defaults to US if not provided.

customField1string

Custom field 1 for vendor

customField2string

Custom field 2 for vendor

customerVendorAccountstring

Account number of paypoint in the vendor side.

einstring

EIN/Tax ID for vendor. Must be nine digits formatted as XX-XXXXXXX (for example, 12-3456789).

emailstring email

Email address.

internalReferenceIdinteger

Internal identifier for global vendor account.

locationCodestring

A location code used to identify the vendor's location.

mccstring

Business Merchant Category Code (MCC). This resource lists MCC codes.

name1string

Primary name for vendor. Required for new vendor.

name2string

Secondary name for vendor. If provided, allowed characters are the same as the name1 field.

payeeName1string

Alternative name used to receive paper check.

payeeName2string

Alternative name used to receive paper check.

paymentMethodstring

The vendor's preferred payment method. Can be one of:

  • managed — Managed payment method
  • vcard — Virtual card payment method
  • check — Check payment method
  • ach — ACH payment method
phonestring

Vendor's phone number. Phone number can't contain non-digit characters like hyphens or parentheses.

remitAddress1string

Remittance street address. Used for mailing paper checks. Required if any remittance address field is provided.

For a PO Box address, include only the PO Box in this field, for example PO Box 29652. Put the rest of the address, such as a department number, in remitAddress2.

remitAddress2string

Remittance address additional line, such as a suite or unit number. Used for mailing paper checks. Always optional.

For a PO Box address, this field holds the part of the address that follows the PO Box, for example Dept# 880662.

remitCitystring

Remittance address city. Used for mailing paper checks. Required if any remittance address field is provided.

remitCountrystring

Remittance address country. Used for mailing paper checks. Must be US or CA. Defaults to US if not provided.

remitEmailstring email

Remittance email address. Used for sending virtual cards and other information about payouts.

remitStatestring

Remittance address state or province. Used for mailing paper checks. Required if any remittance address field is provided. Must be a valid US state or Canadian province abbreviation.

remitZipstring

Remittance address ZIP or postal code. Used for mailing paper checks. Required if any remittance address field is provided. For US addresses, use five digits or ZIP+4 format.

statestring

Vendor's state or province. Required if any address field is provided. Must be a valid US state abbreviation (such as CA, NY) or Canadian province abbreviation (such as ON, BC), depending on the country value.

vendorStatusinteger

Vendor's status. Allowed values:

  • 0 Inactive
  • 1 Active
  • -99 Deleted
zipstring

Vendor's ZIP or postal code. Required if any address field is provided. For US addresses, use five digits (12345) or ZIP+4 format (12345-6789).

defaultMethodIdstring

Identifier for the vendor's default stored payment method.

Response

Success

isSuccessboolean

Boolean indicating whether the operation was successful. A true value indicates success. A false value indicates failure.

pageIdentifierstring

Auxiliary validation used internally by payment pages and components.

responseCodeinteger

Code for the response. Learn more in API Response Codes.

responseDatainteger

If the request was successful, this field contains the identifier for the vendor.

responseTextstring required

Response text for operation: 'Success' or 'Declined'.

Changes

No recorded changes to this operation across all 1 revision of this API.