The Update Vendor request enables you to change any of the following settings for an existing vendor:
- Vendor address
- Vendor email
- Vendor first and last name
- Vendor business name
- Vendor phone
- Vendor URL
- Vendor frequency and delay
- Vendor principal
- Vendor agreement
- Vendor payout information
Note: Modifying certain vendor properties may result in vendor payout suspension. Click here to learn more.
Important
It is suggested that you first retrieve the vendor and then modify the desired property.
To be eligible for payout, make sure all necessary vendor information has been submitted to BlueSnap. To see the payout requirements, click here.
Tip
You can test out a request that hits our sandbox in real-time. Follow the instructions here to use the "Try It!" feature on the right side.
Request Content
vendor
object required, contains the following properties (see vendor) :
Property | Type | Required |
---|---|---|
email | string | required |
name | string | optional |
firstName | string | optional |
lastName | string | optional |
phone | string | optional |
address | string | optional |
city | string | optional |
country | string | required |
state | string | required if payoutInfo included and country = US or CA. (See State and Province Codes) |
zip | string | optional |
taxId | string | optional |
vatId | string | optional |
vendorUrl | string | optional |
defaultPayoutCurrency | string | optional |
frequency | string | optional |
delay | integer | optional |
vendorPrincipal | container | optional; (see vendorPrincipal) |
vendorAgreement | container | optional; (see vendorAgreement) |
payoutInfo | container | optional; (see payoutInfo) |
Response Details
If successful, the response HTTP status code is 204 No Content
Examples
Request Examples
curl -v -X PUT https://sandbox.bluesnap.com/services/2/vendors/514147 \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"email": "[email protected]",
"name": "Important Vendor",
"firstName": "Joe",
"lastName": "Smith",
"address": "123 Main Street",
"city": "testing city",
"zip": "02453",
"country": "US",
"phone": "1-054-976-6778",
"state": "MA",
"taxId": 123456789,
"vendorUrl": "http://mycompany.com",
"ipnUrl": "https://ipnaddress.com",
"defaultPayoutCurrency": "USD",
"vendorPrincipal": {
"firstName": "Joe",
"lastName": "Smith",
"address": "123 Main Street",
"city": "Juneau",
"zip": "02453",
"country": "US",
"dob": "28-09-9999",
"personalIdentificationNumber": 1234,
"driverLicenseNumber": "561196411",
"email": "[email protected]"
},
"payoutInfo": [
{
"payoutType": "ACH",
"baseCurrency": "USD",
"nameOnAccount": "vendor",
"bankAccountClass": "PERSONAL",
"bankAccountType": "CHECKING",
"bankName": "Leumi",
"bankId": "123456789",
"country": "US",
"city": "Portland",
"address": "1 bank address",
"state": "MA",
"zip": "02453",
"bankAccountId": "123456789",
"minimalPayoutAmount": 50,
"paymentReference": "Payment for vendor 1234",
"refundReserve": 200
}
],
"vendorAgreement": {
"commissionPercent": 20,
"accountStatus": "ACTIVE"
}
}'
curl -v -X PUT https://sandbox.bluesnap.com/services/2/vendors/514147 \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"email": "[email protected]",
"name": "Important Vendor",
"firstName": "Joe",
"lastName": "Smith",
"address": "123 Main Street",
"city": "testing city",
"zip": "02453",
"country": "US",
"phone": "1-054-976-6778",
"state": "MA",
"taxId": 123456789,
"ipnUrl": "https://ipnaddress.com",
"defaultPayoutCurrency": "USD",
"vendorPrincipal": {
"firstName": "Joe",
"lastName": "Smith",
"address": "123 Main Street",
"city": "Juneau",
"zip": "02453",
"country": "US",
"dob": "28-09-9999",
"personalIdentificationNumber": 1234,
"driverLicenseNumber": "561196411",
"email": "[email protected]"
},
"payoutInfo": [
{
"payoutType": "ACH",
"baseCurrency": "USD",
"nameOnAccount": "vendor",
"bankAccountClass": "PERSONAL",
"bankAccountType": "CHECKING",
"bankName": "Leumi",
"bankId": "123456789",
"country": "US",
"city": "Portland",
"address": "1 bank address",
"state": "MA",
"zip": "02453",
"bankAccountId": "36628822",
"minimalPayoutAmount": 50,
"paymentReference": "Payment for vendor 1234",
"refundReserve": 200
}
],
"vendorAgreement": {
"commissionPercent": 20,
"accountStatus": "INACTIVE",
"recurringCommission": "Y"
}
}'
curl -v -X PUT https://sandbox.bluesnap.com/services/2/vendors/534231 \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"email": "[email protected]",
"name": "Business ABC",
"address": "25 Business Avenue",
"city": "Boston",
"zip": "02453",
"country": "US",
"phone": "555-555-5555",
"state": "MA",
"taxId": 123456789,
"defaultPayoutCurrency": "USD",
"ipnUrl": "https://ipnaddress.com",
"vendorPrincipal": {
"firstName": "Joe",
"lastName": "Smith",
"address": "123 Main Street",
"city": "Boston",
"zip": "12345",
"country": "US",
"dob": "28-09-9999",
"personalIdentificationNumber": "1234",
"driverLicenseNumber": "7676234872",
"email": "[email protected]"
},
"payoutInfo": [
{
"payoutType": "ACH",
"baseCurrency": "USD",
"minimalPayoutAmount": "50",
"nameOnAccount": "name of vendor account",
"bankAccountClass": "CORPORATE",
"bankAccountType": "CHECKING",
"bankName": "Bank of America",
"bankId": "123456789",
"country": "US",
"city": "Boston",
"address": "1 bank address",
"state": "MA",
"zip": "02453",
"bankAccountId": "36628822",
"minimalPayoutAmount": 50,
"paymentReference": "Payment for vendor 1234",
"refundReserve": 200
}
],
"vendorAgreement": {
"commissionPercent": 30
}
}'
Response Example
HTTP/ 1.1 204 No Content
API Explorer
To test out a call, enter an existing vendor ID, such as 514147, into the vendorId field below (the ID will automatically be inserted into the URL). Click the "Try It!" button in the right-hand column to test using the default, pre-populated sample values. To test with your own values, edit the parameter fields below. You'll see them populate in the right-hand column and you can click the "Try It!" button to submit your test request and see a response.