API referencePay Out endpointsVendor

Update vendor

Updates a vendor's information. Send only the fields that need to be updated.

Authentication

requestTokenstring
API Key authentication via header

Path parameters

idVendorintegerRequired
Vendor ID.

Request

This endpoint expects an object.
vendorNumberstringOptional
Custom number identifying the vendor. Must be unique in paypoint.
AdditionalDatamap from strings to optional maps from strings to anyOptional

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. Example usage:

1{
2  "additionalData": {
3    "key1": "value1",
4    "key2": "value2",
5    "key3": "value3"
6  }
7}
address1stringOptional
Vendor's address
address2stringOptional
Additional line for vendor's address.
billingDataobjectOptional
Object containing vendor's bank information.
citystringOptional
Vendor's city.
contactslist of objectsOptional
Array of objects describing the vendor's contacts.
countrystringOptional
Vendor's country.
customerVendorAccountstringOptional
Account number of paypoint in the vendor side.
einstringOptional

EIN/Tax ID for vendor.

emailstringOptionalformat: "email"<=320 characters
Vendor's email address. Required for vCard.
internalReferenceIdlongOptional
Internal identifier for global vendor account.
locationCodestringOptional
Additional location code used to identify the vendor.
mccstringOptional

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

name1stringOptional
Primary name for vendor. Required for new vendor.
name2stringOptional
Secondary name for vendor.
payeeName1stringOptional
Alternative name used to receive paper check.
payeeName2stringOptional
Alternative name used to receive paper check.
paymentMethodobjectOptional
Object containing details about the payment method to use for the payout.
phonestringOptionalformat: "^[0-9]+$"

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

remitAddress1stringOptional
Remittance address. Used for mailing paper checks.
remitAddress2stringOptional
Remittance address additional line. Used for mailing paper checks.
remitCitystringOptional
Remittance address city. Used for mailing paper checks.
remitCountrystringOptional
Remittance address country. Used for mailing paper checks.
remitStatestringOptional
Remittance address state. Used for mailing paper checks.
remitZipstringOptional
Remittance address ZIP code. Used for mailing paper checks.
statestringOptional
Vendor's state. Must be a 2 character state code.
vendorStatusintegerOptional

Vendor’s status. Allowed status:

  • 0 Inactive

  • 1 Active

zipstringOptional
Vendor's zip code.

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

Response text for operation: ‘Success’ or ‘Declined’.

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error
503
Service Unavailable Error