{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Reporting","type":"basic","slug":"reporting","excerpt":"Learn about our reporting capabilities available through the Merchant Portal and Reporting API\nIf you have questions after reading this guide, check out our [FAQs page](https://support.bluesnap.com/docs/faqs-marketplace).","body":"This section will cover the following topics: \n* [Reporting overview](#section-reporting-overview)\n* [Common reporting scenarios](#section-common-reporting-scenarios)\n\n##Reporting overview\nTo keep track of your vendors, use our reports to review topics, such as transaction details and payout summaries.  Additionally, you can run a report to see all your vendors and specific details associated with each.  Your vendor reporting detail is available through both the BlueSnap Merchant Portal and our [Reporting API](/v8976-Tools/docs/reporting-api-overview).  \n\nYour vendor details can be found within the following reports:\n\n  * Account Balance report \n  * Account Balance Detail report\n  * Sales by Product & Currency report\n  * Transactions Summary report\n  * Transaction Details report\n  * Declined Transactions report\n  * Subscriptions reports\n  * Payout Details report\n  * Payout Summary Statement report\n  * Vendor Details report\n\nMore information on reporting can be found [here](https://support.bluesnap.com/docs/reporting).\n\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##Common reporting scenarios \n###Scenario 1: Communicating payout information to your vendor\nUse the Payout Detail report to communicate payout information to your vendor. To run the report via our [Reporting API](/v8976-Tools/docs/get-report-data), include the URL parameters `forvendorid` and `period` in the query string. Note that the value for `forvendorid` is the vendor ID and `period` is the period for which you would like to run the report. \n\nSuppose that you want to run the report for vendor ID 515503 for the last six months. The API endpoint for **sandbox** will be: \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://sandbox.bluesnap.com/services/2/report/PayoutDetail?period=LAST_6_MONTHS&forvendorid=515503\",\n      \"language\": \"text\",\n      \"name\": \"Payout Detail: API Endpoint\"\n    }\n  ]\n}\n[/block]\n###Scenario 2: Communicating sales history to your vendor\nSuppose your vendor (whose vendor ID is 515503) would like to know their sales history for the last three months. To provide this information, you'll run the Transaction Detail report. To do this via our Reporting API, you'll pass the URL parameters `vendor`, `period`, and `transactionType` in the query string. The resulting endpoint for **sandbox** will be: \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://sandbox.bluesnap.com/services/2/report/TransactionDetail?period=LAST_3_MONTHS&transactionType=SALE&vendor=515503\",\n      \"language\": \"text\",\n      \"name\": \"Transaction Detail: API Endpoint \"\n    }\n  ]\n}\n[/block]\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##Next: Payout \nNow that you've learned about our reporting capabilities, move on to learn about payout. \n\n**[➔ Payout](/docs/payout)**","updates":[],"order":8,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"62178c1e445ec2009631ec1e","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Marketplace/Split Payments","slug":"marketplace","order":4,"from_sync":false,"reference":false,"_id":"62178c1e445ec2009631ebee","version":"62178c1e445ec2009631ec4d","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2017-03-17T15:51:04.102Z","__v":1},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"version":"8976-Embedded-Payments","version_clean":"8976.0.0-Embedded-Payments","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["62178c1e445ec2009631ebeb","62178c1e445ec2009631ebec","62178c1e445ec2009631ebed","62178c1e445ec2009631ebee","62178c1e445ec2009631ebef","62178c1e445ec2009631ebf0","5beb278ac442ab0213f00990","62178c1e445ec2009631ebf1","5c3f542c12c4ac004bc51718","62178c1e445ec2009631ebf2","5df806ccecebde0059f17225","5dfa8a8f340c2b007418eb8a","62178c1e445ec2009631ebf3","5e597199fd2b0200117c2c1c"],"_id":"62178c1e445ec2009631ec4d","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"6183ed028202aa00161024e9","createdAt":"2018-04-23T14:36:48.535Z","releaseDate":"2018-04-23T14:36:48.535Z"},"createdAt":"2017-03-30T13:17:19.675Z","githubsync":"","__v":0}

Overview

BlueSnap Dash™

BlueSnap Relay™

BlueSnap Relay™ API References

Marketplace/Split Payments

Reporting

Learn about our reporting capabilities available through the Merchant Portal and Reporting API If you have questions after reading this guide, check out our [FAQs page](https://support.bluesnap.com/docs/faqs-marketplace).

This section will cover the following topics:

Reporting overview

To keep track of your vendors, use our reports to review topics, such as transaction details and payout summaries. Additionally, you can run a report to see all your vendors and specific details associated with each. Your vendor reporting detail is available through both the BlueSnap Merchant Portal and our Reporting API.

Your vendor details can be found within the following reports:

  • Account Balance report
  • Account Balance Detail report
  • Sales by Product & Currency report
  • Transactions Summary report
  • Transaction Details report
  • Declined Transactions report
  • Subscriptions reports
  • Payout Details report
  • Payout Summary Statement report
  • Vendor Details report

More information on reporting can be found here.

Back to Top

Common reporting scenarios

Scenario 1: Communicating payout information to your vendor

Use the Payout Detail report to communicate payout information to your vendor. To run the report via our Reporting API, include the URL parameters forvendorid and period in the query string. Note that the value for forvendorid is the vendor ID and period is the period for which you would like to run the report.

Suppose that you want to run the report for vendor ID 515503 for the last six months. The API endpoint for sandbox will be:

Payout Detail: API Endpoint
https://sandbox.bluesnap.com/services/2/report/PayoutDetail?period=LAST_6_MONTHS&forvendorid=515503

Scenario 2: Communicating sales history to your vendor

Suppose your vendor (whose vendor ID is 515503) would like to know their sales history for the last three months. To provide this information, you'll run the Transaction Detail report. To do this via our Reporting API, you'll pass the URL parameters vendor, period, and transactionType in the query string. The resulting endpoint for sandbox will be:

Transaction Detail: API Endpoint 
https://sandbox.bluesnap.com/services/2/report/TransactionDetail?period=LAST_3_MONTHS&transactionType=SALE&vendor=515503

Back to Top

Next: Payout

Now that you've learned about our reporting capabilities, move on to learn about payout.

➔ Payout