Fetch recent transactions

GET https://staging-onlinemerchants.suregifts.com/api/v2/transactions

This endpoint retrieves a list of recent transactions for the authenticated merchant. Transactions include activations, redemptions, reversals, and other operations.

Request

Method: GET
URL: /merchant-client/v2/transactions
Query Parameters: None
Body: None

Responses

200 OK – Successful

Field Descriptions:

• data (array) – List of recent transactions with details.
  • Each transaction includes: transactionId, transactionType, amount, timestamp, reference, voucherCode, serialNumber, refundStatus, note.
  • refundStatus values: "CANCELLED" (reversed), "NEW" (created from update), or null (normal).
• statusCode (string) – Status code ("00" indicates success).
• message (string) – Human-readable message.

401 Unauthorized

Returned when authentication fails.

Unauthorized

Example cURL Request

Bash

curl -X GET \
  'https://{baseUrl}/merchant-client/v2/transactions' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json'

Endpoint:

GET /api/v2/transactions

Description:
Retrieves the most recent 50 voucher transactions recorded in your SureGifts account. Transactions can be of type ACTIVATION (voucher activation) or REDEMPTION (voucher redemption).

---

Response

The response will always return with HTTP status 200 if the request is valid at the transport level. The actual success or failure of the request is determined by the statusCode field in the JSON body.

Example Successful Response:

JSON

{
  "data": [
    {
      "voucherCode": "112*** ***862",
      "serialNumber": "300002137",
      "transactionId": "96",
      "transactionType": "ACTIVATION",
      "amount": 5000.00,
      "timestamp": "2025-08-15T16:53:03.382Z",
      "reference": "123451"
    }
  ],
  "statusCode": "00",
  "message": "Successful"
}

Field Descriptions:

• voucherCode — The masked voucher code involved in the transaction.
• serialNumber — Serial number of the voucher.
• transactionId — Unique identifier for the transaction, generated by SureGifts.
• transactionType — Either ACTIVATION or REDEMPTION.
• amount — Amount of the transaction.
• timestamp — Date and time of the transaction.
• reference — The unique reference you provided when initiating the transaction.
• statusCode — SureGifts business status code (check for 00 to confirm success).
• message — Human-readable description of the status.

---

Developer Notes

1. Always check statusCode to determine business success.
2. The data array contains up to 50 of the most recent transactions.
3. If you need more historical data, you will need to contact SureGifts for extended reporting.
4. Mask voucher codes in logs for security.