Overview
This API can be used to retrieve a detailed transaction report including purchases, status, amount and fee details.
Detailed report
Request Headers
Property |
Required |
Type |
Description |
sunbit-key |
yes |
text |
Provided to you by Sunbit |
sunbit-secret |
yes |
text |
Provided to you by Sunbit |
Body
Attribute |
Required |
Type |
Description |
location |
no |
text |
If not provided, the response will include all locations of the partner |
fromDate |
yes |
date |
Format: YYYY-MM-DD |
toDate |
yes |
date |
Format: YYYY-MM-DD |
Response
Attribute |
Type |
Description |
content |
DetailedReport[] |
Array of DetailedReport aggregate per location |
DetailedReport
Attribute |
Type |
Description |
location |
text |
|
customerId |
number |
Customer id |
dateTime |
LocalDateTime |
Purchase date time as format : YYYY-MM-DD’T’hh:mm:ss |
status |
text |
- DECLINED
- PURCHASED
- APPROVED
|
amount |
number |
Purchase amount |
fee |
number |
Fee collected by Sunbit |
Example
Request
curl -X POST 'https://api-sandbox.sunbit.com/reports/api/v1/detailed' \
-H 'Content-Type: application/json' \
-H 'sunbit-key: YOUR_KEY' \
-H 'sunbit-secret: YOUR_SECRET' \
-d '{
"fromDate": "2024-04-01",
"toDate": "2024-04-15",
"location": "sandbox"
}'
Response
{
"content": [
{
"location": "sandbox",
"customerId": 2731,
"dateTime": "2024-04-10T09:45:39",
"status": "PURCHASED",
"amount": 341.46,
"fee": 10.24
}
]
}
Errors
Error Code |
Message |
Description |
404 |
Resource Not Found |
Location was not found |
403 |
Bad Credentials |
sunbit-key and/or sunbit-secret do not match any alliance credentials |
500 |
Internal Server Error |
Something went wrong on Sunbit’s side |