Skip to main content
POST
/
api
/
v2.1
/
fincard
/
virtual
/
card
/
authorize
/
transaction
Card Authorization Transaction
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/card/authorize/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"
      }
    ]
  }
}

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