{"_id":"59dfa5858b51880010b74aef","category":{"_id":"59dfa5828b51880010b74abf","version":"59dfa5828b51880010b74ab6","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-11-23T19:23:42.327Z","from_sync":false,"order":8,"slug":"marketplace","title":"Marketplace"},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"_id":"59dfa5828b51880010b74ab6","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-10-12T17:25:22.850Z","releaseDate":"2017-10-12T17:25:22.850Z","categories":["59dfa5828b51880010b74ab7","59dfa5828b51880010b74ab8","59dfa5828b51880010b74ab9","59dfa5828b51880010b74aba","59dfa5828b51880010b74abb","59dfa5828b51880010b74abc","59dfa5828b51880010b74abd","59dfa5828b51880010b74abe","59dfa5828b51880010b74abf","59dfa5828b51880010b74ac0","59dfa5828b51880010b74ac1","59dfa5828b51880010b74ac2","59dfa5828b51880010b74ac3","59dfa5828b51880010b74ac4","59dfa5828b51880010b74ac5"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.23 Release","version_clean":"8976.0.0-JSON","version":"8976-JSON"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-11-23T19:25:17.640Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[]},"settings":"57ee593a21ceb20e0061959e","auth":"optional","params":[{"_id":"586e74439d4a1d3700763687","ref":"","in":"path","required":true,"desc":"BlueSnap identifier for the vendor","default":"","type":"int","name":"vendorId"}],"url":"/vendors/:vendorId"},"isReference":false,"order":3,"body":"[block:html]\n{\n  \"html\": \"<script>\\n  // hide body textbox of API Explorer\\n $(document).ready(function() {\\n  $(\\\"textarea[placeholder='Body Content']\\\").hide();  \\n }); \\n</script>\"\n}\n[/block]\nThe Retrieve Vendor request enables you to retrieve details about one existing vendor.\n\n<a class=\"btn btn-success\" href=\"#section-api-explorer-for-request-based-on-vendorid-\" role=\"button\">Try it in the API Explorer</a>\n\n###Request Content\nEnter the `vendorId` into the web service URL, in the format:\n`services/2/vendors/{vendorId}`\n\nFor example:\n`services/2/vendors/2111111`\n\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the retrieved [vendor](doc:vendorinfo).\n\n<hr>\n\n##Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/vendors/514151 \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\",\n      \"language\": \"curl\",\n      \"name\": \"Retrieve Vendor Request\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"vendorId\\\": \\\"514151\\\",\\n    \\\"email\\\": \\\"test.vendor:::at:::bluesnap.com\\\",\\n    \\\"name\\\": \\\"BlueSnap test\\\",\\n    \\\"firstName\\\": \\\"Jane\\\",\\n    \\\"lastName\\\": \\\"Shopper\\\",\\n    \\\"city\\\": \\\"Chicago\\\",\\n    \\\"zip\\\": \\\"67114\\\",\\n    \\\"country\\\": \\\"US\\\",\\n    \\\"state\\\": \\\"KS\\\",\\n    \\\"defaultPayoutCurrency\\\": \\\"USD\\\",\\n    \\\"frequency\\\": \\\"DAILY\\\", \\n    \\\"delay\\\": 3,\\n    \\\"vendorPrincipal\\\": {\\n      \\\"firstName\\\": \\\"Jane\\\",\\n      \\\"lastName\\\": \\\"Shopper\\\",\\n      \\\"address\\\": \\\"13 Maple St.\\\",\\n      \\\"city\\\": \\\"Chicago\\\",\\n      \\\"zip\\\": \\\"4640802\\\",\\n      \\\"country\\\": \\\"US\\\",\\n      \\\"dob\\\": \\\"28-09-1979\\\",\\n      \\\"email\\\": \\\"test.vendor@bluesnap.com\\\",\\n      \\\"driverLicenseNumber\\\": \\\"561196411\\\"\\n    },\\n    \\\"payoutInfo\\\": {\\n      \\\"payoutType\\\": \\\"ACH\\\",\\n      \\\"baseCurrency\\\": \\\"USD\\\",\\n      \\\"minimalPayoutamount\\\": \\\"20\\\",\\n      \\\"nameOnAccount\\\": \\\"Jane Shopper\\\",\\n      \\\"bankAccountClass\\\": \\\"PERSONAL\\\",\\n      \\\"bankAccountType\\\": \\\"CHECKING\\\",\\n      \\\"bankName\\\": \\\"First Bank of Newton\\\",\\n      \\\"bankId\\\": \\\"12445\\\",\\n      \\\"country\\\": \\\"us\\\",\\n      \\\"city\\\": \\\"Newton\\\",\\n      \\\"address\\\": \\\"128 E Broadway St\\\",\\n      \\\"state\\\": \\\"IL\\\",\\n      \\\"zip\\\": \\\"67114\\\",\\n      \\\"bankAccountId\\\": \\\"36628822\\\"\\n    },\\n    \\\"vendorAgreement\\\": {\\n      \\\"commissionPercent\\\": \\\"30\\\",\\n      \\\"accountStatus\\\": \\\"ACTIVE\\\",\\n      \\\"recurringCommission\\\": \\\"Y\\\"\\n    },\\n    \\\"verification\\\": {\\n      \\\"payoutStatus\\\": \\\"Incomplete\\\",\\n      \\\"processingStatus\\\": \\\"Active\\\",\\n      \\\"missingItems\\\": [\\n        \\\"vendor.phone\\\",\\n        \\\"vendor.address\\\",\\n        \\\"vendor.principal.personalIdentificationNumber\\\"\\n      ]\\n    }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Retrieve Vendor Response\"\n    }\n  ]\n}\n[/block]\n##Example Descriptions\n\n###Retrieve Vendor: full details\nThis example shows a vendor retrieval based on `vendorId`. This vendor's processing status is **Active**, which means they can have transactions processed on their behalf. Their payout status is **Incomplete**, which means BlueSnap has not been provided with sufficient information to fully board this vendor (payout is suspended at this time). `missingItems` inside of `verification` provides a list of the missing information needed for the vendor to be eligible for payout. \n\nThe following properties are missing: \n* `phone` and `address` inside `vendor`\n* `personalIdentificationNumber` inside `vendorPrincipal` \n\nFor more information, visit the [Marketplace Guide](/docs/vendor-onboarding#section-understanding-your-vendor-s-statuses).\n<hr>\n\n##API Explorer (for request based on vendorId)\nTo test out a call, enter an existing vendor ID (e.g *514151*) in the `vendorId` field. This will automatically insert the ID into the request URL.","excerpt":"","slug":"retrieve-vendor","type":"get","title":"Retrieve Vendor"}

getRetrieve Vendor


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

vendorId:
required
integer
BlueSnap identifier for the vendor

Documentation

The Retrieve Vendor request enables you to retrieve details about one existing vendor.

Try it in the API Explorer

Request Content

Enter the vendorId into the web service URL, in the format:
services/2/vendors/{vendorId}

For example:
services/2/vendors/2111111

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the retrieved vendor.


Examples

Request Examples

curl -v -X GET https://sandbox.bluesnap.com/services/2/vendors/514151 \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='

Response Examples

{
    "vendorId": "514151",
    "email": "test.vendor@bluesnap.com",
    "name": "BlueSnap test",
    "firstName": "Jane",
    "lastName": "Shopper",
    "city": "Chicago",
    "zip": "67114",
    "country": "US",
    "state": "KS",
    "defaultPayoutCurrency": "USD",
    "frequency": "DAILY", 
    "delay": 3,
    "vendorPrincipal": {
      "firstName": "Jane",
      "lastName": "Shopper",
      "address": "13 Maple St.",
      "city": "Chicago",
      "zip": "4640802",
      "country": "US",
      "dob": "28-09-1979",
      "email": "test.vendor@bluesnap.com",
      "driverLicenseNumber": "561196411"
    },
    "payoutInfo": {
      "payoutType": "ACH",
      "baseCurrency": "USD",
      "minimalPayoutamount": "20",
      "nameOnAccount": "Jane Shopper",
      "bankAccountClass": "PERSONAL",
      "bankAccountType": "CHECKING",
      "bankName": "First Bank of Newton",
      "bankId": "12445",
      "country": "us",
      "city": "Newton",
      "address": "128 E Broadway St",
      "state": "IL",
      "zip": "67114",
      "bankAccountId": "36628822"
    },
    "vendorAgreement": {
      "commissionPercent": "30",
      "accountStatus": "ACTIVE",
      "recurringCommission": "Y"
    },
    "verification": {
      "payoutStatus": "Incomplete",
      "processingStatus": "Active",
      "missingItems": [
        "vendor.phone",
        "vendor.address",
        "vendor.principal.personalIdentificationNumber"
      ]
    }
}

Example Descriptions

Retrieve Vendor: full details

This example shows a vendor retrieval based on vendorId. This vendor's processing status is Active, which means they can have transactions processed on their behalf. Their payout status is Incomplete, which means BlueSnap has not been provided with sufficient information to fully board this vendor (payout is suspended at this time). missingItems inside of verification provides a list of the missing information needed for the vendor to be eligible for payout.

The following properties are missing:

  • phone and address inside vendor
  • personalIdentificationNumber inside vendorPrincipal

For more information, visit the Marketplace Guide.


API Explorer (for request based on vendorId)

To test out a call, enter an existing vendor ID (e.g 514151) in the vendorId field. This will automatically insert the ID into the request URL.


User Information

Try It Out


get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}