Postman guide
Last updated: April 29, 2022
Learn how to create requests and receive responses from both the payments and statements endpoints of the Reconciliation API, using the Postman application.
- Download and install the Postman application. You can find it here: https://www.getpostman.com.
- Grab your secret key. You can find it in the Hub under Settings > Channels.
In the GET field, enter the following endpoint:
To use this endpoint, you need to specify one of the 3 parameters below:
- date / time in ISO format
- payment ID (
paymentId) - reference (
reference)
In the example below, we'll specify the date / time, i.e., the timeframe during which the payments occurred.
In the Params tab, enter From in the Key column. Add the start date of your timeframe in the Value column — this must be in ISO format (YYYY-MM-DD). In the row below, enter To in the Key column and the end date of your timeframe in the Value column.
You can also add your parameter directly to your endpoint. For example:
Information
The same logic applies for the other available parameters:
After setting your parameters, you need to authenticate your request with your secret key and specify the response format you would like to receive.
In the Headers tab, enter Authorization in the Key column. In the Value column, add your secret key. You can find your secret key in the Settings > Channels section of the Hub. Next, enter Content-Type in the Key column and application/json in the Value column.
Select Send to submit your request.
The response will be displayed in the bottom half of your screen.
Add /download in the URL field after payments, like this:
Select the down arrow to the right of the Send button, then select Send and Download.
Once the download is complete, save the file to your preferred location. You can name it anything you like — just make sure your filename ends in .csv.
In the GET field, enter the following endpoint:
Note
When using the statements endpoint, you must include a date for when the Statement ID was created (or the timeframe in which it was created).
In the Headers tab, enter Authorization in the Key column. In the Value column, add your secret key. You can find your secret key in the Settings > Channels section of the Hub.
Next, enter Content-Type in the Key column and application/json in the Value column.
The end result should look something like this:
Select Send to submit your request.
The JSON response will be displayed in the bottom half of your screen.
Add /download in the URL field after statements, like this:
Select the down arrow to the right of the Send button, then select Send and Download.
Once the download is complete, save the file to your preferred location. You can name it anything you like — just make sure your filename ends in .csv.
You can break down the detail even further by using the payout_breakdown field. This will provide all totals from each section of the statement.
Set up your request as above, then simply add &include=payout_breakdown at the end of the URL.
For example:
Tip
You can download a CSV copy by adding /download after statements in the URL, like this:
This extension will allow you to retrieve the list of payments and associated fees included in a given statement, payout or payout currency.
You can filter your request using any of the three parameters defined below.
Tip
You can download a CSV copy by adding /download after payments in the URL, like this: