Get Card Transactions

POST

/api/v{{apiVersion}}/business/card/transactions

DTO: CardTransactionRequestDto

cardId, optional paging (pageNumber, pageSize), transactionType, transactionId, date range.

Response: ApiResponse<GetCardTransactionResponse>.

Signing: Signature is over the exact serialized body; prefer compact JSON or match .NET defaults. Nullable fields omitted vs null can change the hash — keep body stable or mirror your client serializer.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://api-dev.usenumero.com/numeroaccount/api/v{{apiVersion}}/business/card/transactions' \
--header '{{headerApiKeyName}}: {{businessApiKey}}' \
--header '{{headerSignatureName}}: {{requestSignature}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "cardId": "CARD_ID_FROM_ISSUE_OR_LIST",
  "pageNumber": 1,
  "pageSize": 20,
  "transactionType": null,
  "transactionId": null,
  "startDate": null,
  "endDate": null
}'

Response Example

{
  "status": true,
  "message": "Success",
  "code": "00",
  "version": "v1",
  "reference": "N2026032512010005",
  "data": {
    "transactionResponse": [
      {
        "id": 1001,
        "cardId": "card_mid_abc123",
        "merchantName": "Coffee Shop",
        "merchantCity": "Lagos",
        "merchantState": "LA",
        "merchantMcc": "5812",
        "merchantCountry": "NG",
        "transactionType": "debit",
        "transactionStatus": "settled",
        "transactionAmount": 2500,
        "currencyCode": "NGN",
        "transactionTime": "2026-03-25T10:15:00",
        "description": "POS purchase",
        "network": "VISA",
        "authorizationAmount": 2500,
        "authorizationCurrencyCode": "NGN",
        "balanceAfterTransaction": 14750.5,
        "createdAt": "2026-03-25T10:15:02"
      }
    ],
    "currentPage": 1,
    "pageSize": 20,
    "totalCount": 1,
    "totalPages": 1
  },
  "error": null
}

Modified at 2026-03-25 19:02:22

Deactivate Card

Get Merchant Customers