Skip to main content
POST
/
api
/
v2.1
/
fincard
/
virtual
/
card
/
3ds
/
transaction
Card 3DS Transaction
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/card/3ds/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,
  "threeDsType": "OTP",
  "threeDsVersion": "2.1.0"
}
'
{
  "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

3DS transaction request

3DS transaction 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

threeDsType
string

3DS type

Example:

"OTP"

threeDsVersion
string

3DS version

Example:

"2.1.0"

Response

Successful response

3DS transaction 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