Time-Limited Transaction Report

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 the data, generated using your secret_key.

Signature Formula:

sign = HMAC_SHA256(base64(data), secret_key)

🔧 Body Parameters

NameTypeRequiredDescription
datastringA base64-encoded JSON string containing report filters
signstringA 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 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" } ] } 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 a sign parameter generated using your secret_key.