Get Transactions
Last updated
Last updated
GET {{baseUrl}}/customer/virtual/cards/get/{{card_id}}
This endpoint retrieves the transaction history of a specific virtual card using the card's unique identifier.
No specific headers are required for this endpoint, but typically, you might need to include authorization tokens or other headers as per your API's authentication requirements.
The response will include the status of the request, a relevant message, and a list of transactions associated with the specified virtual card if the request is successful. If the request is invalid, an error message will be returned.
If the request is invalid or there are issues processing the request, the following error response will be returned:
status: Indicates the success status of the request (e.g., "success").
status_code: HTTP status code of the response (e.g., 200 for success).
message: A message describing the result of the request (e.g., "Request successful").
data: Contains a list of transactions related to the virtual card.
id: Unique identifier of the transaction.
createdAt: The timestamp when the transaction was created.
updatedAt: The timestamp when the transaction was last updated.
amount: The amount involved in the transaction.
centAmount: The amount in cents (useful for handling currencies that require precision).
type: Type of the transaction (e.g., "debit" or "credit").
method: Method of the transaction (e.g., "withdrawal" or "topup").
narrative: Description or narrative of the transaction.
status: Status of the transaction (e.g., "success").
currency: Currency used in the transaction (e.g., "usd").
reference: Reference identifier for the transaction.
cardId: Unique identifier of the virtual card associated with the transaction.
By following the above details, you can retrieve the transaction history for a specific virtual card.
{"status":"success","status_code":200,"message":"Request successful","data":[{"id":"fd61faa8-c339-4155-b023-a241b145a7da","createdAt":"2024-10-24T12:52:09.686Z","updatedAt":"2024-10-24T12:52:15.246Z","amount":"3","centAmount":"300","cardBalanceAfter":"300","type":"credit","method":"topup","narrative":"Top-up card","status":"success","currency":"usd","reference":"CREATE_CARD_d97d9a3a5cc3","transactionType":null,"cardId":"112912c5-756f-4bca-a6bc-26b08b203a77","authorizationTransactionId":null,"settlementTransactionId":null}]}OK