Skip to main content
POST
/
api
/
v2.1
/
fincard
/
virtual
/
card
/
transaction
Card Operation Transaction
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/card/transaction \
  --header 'Content-Type: application/json' \
  --header 'X-Forwarded-From: <x-forwarded-from>' \
  --data '
{
  "cardId": "<string>",
  "transactionType": "<string>",
  "merchantOrderNo": "<string>",
  "orderNo": "<string>",
  "startTime": 123,
  "endTime": 123,
  "pageNum": 1,
  "pageSize": 10
}
'
{
  "success": true,
  "code": 200,
  "msg": "Success",
  "data": {
    "total": 150,
    "pageNum": 1,
    "pageSize": 10,
    "records": [
      {
        "transactionId": "tx-12345678",
        "cardId": "card-12345678",
        "transactionType": "PURCHASE",
        "transactionStatus": "COMPLETED",
        "amount": 100,
        "currency": "USD",
        "merchantName": "Amazon",
        "merchantCategoryCode": "5411",
        "merchantCategoryDescription": "Grocery Stores",
        "merchantCity": "Seattle",
        "merchantCountry": "US",
        "authorizationCode": "123456",
        "referenceNumber": "REF123456",
        "transactionTime": 1640995200000,
        "settlementTime": 1640995260000,
        "description": "Amazon purchase",
        "isRefund": false,
        "originalTransactionId": "tx-12345677",
        "feeAmount": 1,
        "billingAmount": 100,
        "billingCurrency": "USD",
        "exchangeRate": 1,
        "is3ds": false,
        "isContactless": true,
        "isOnline": true,
        "isInternational": false,
        "isAtm": false,
        "terminalId": "12345678",
        "acquirerId": "87654321"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.finhub.cloud/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
User-Agent
string

User agent

​
X-Forwarded-For
string

Forwarded for

​
X-Forwarded-From
string
required

Client application identifier

Example:

"client-app"

​
X-Tenant-ID
string

Tenant ID

​
deviceId
string

Device ID

​
platform
string

Platform

Body

application/json

Transaction query request

Transaction query request

​
cardId
string

Card ID

​
transactionType
string

Transaction type filter

​
merchantOrderNo
string

Client transaction reference (optional filter)

​
orderNo
string

Order number (optional filter)

​
startTime
integer<int64>

Start time (milliseconds)

​
endTime
integer<int64>

End time (milliseconds)

​
pageNum
integer<int32>
default:1

Current page. Default is 1

​
pageSize
integer<int32>
default:10

Page size. Default 10, maximum 100

Response

Successful response

Transaction query response

​
success
boolean

Success flag

Example:

true

​
code
integer<int32>

Response code

Example:

200

​
msg
string

Response message

Example:

"Success"

​
data
object

Transaction query data