This endpoint allows you to generate a summary report of transactions that occurred within a specified time range. It is typically used for: * Daily reconciliation and settlement checks * Filtering transactions by period, shop ID, or result status * Automating financial reporting on the merchant’s backend
📊 Time-Limited Transaction Report
Endpoint:
POST https://secure.carusell.world/pay/get_report
🕒 Recent Requests
Log in with your api_key
to view request and response history.
📥 Request Structure
The request must include two parameters:
data
: A base64-encoded JSON string containing report filters (e.g., start and end dates).sign
: A HMAC-SHA256 signature based on thedata
, generated using yoursecret_key
.
Signature Formula:
sign = HMAC_SHA256(base64(data), secret_key)
🔧 Body Parameters
Name | Type | Required | Description |
---|---|---|---|
data | string | ✅ | A base64-encoded JSON string containing report filters |
sign | string | ✅ | A HMAC signature created from the data string using your secret_key |
✅ Response
Status Code: 200 OK
Example:
{
"status": "success",
"report": [
{
"order_id": "txn_001",
"amount": "50.00",
"currency": "USD",
"status": "paid",
"created_at": "2025-07-10T09:00:00Z"
},
{
"order_id": "txn_002",
"amount": "20.00",
"currency": "USD",
"status": "failed",
"created_at": "2025-07-10T10:30:00Z"
}
]
}
Response
Status Code: 200 OKExample:
{
"status": "success",
"report": [ { "order_id": "txn_001", "amount": "50.00", "currency": "USD", "status": "paid", "created_at": "2025-07-10T09:00:00Z" }, { "order_id": "txn_002", "amount": "20.00", "currency": "USD", "status": "failed", "created_at": "2025-07-10T10:30:00Z" } ] } The report will contain all matching transactions for the given filters.And here's a matching Description you can place in the endpoint overview:
Use this endpoint to retrieve a time-limited transaction report from the Carusell Payment Gateway.
The report includes all transactions matching the specified filter criteria, such as date range, shop ID, and transaction status.
This is ideal for generating:
- Reconciliation reports
- End-of-day summaries
- Audit trails and payout tracking
A base64-encoded
data
object must be sent with your filters, along with asign
parameter generated using yoursecret_key
.