Skip to main content
POST
/
api
/
v2.1
/
fincard
/
virtual
/
webhook
/
callback
Webhook Callback
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/webhook/callback \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventType": "CARD_OPERATION_TRANSACTION",
  "eventId": "evt-12345678",
  "timestamp": 1640995200000,
  "tenantId": "wsb-12345678",
  "accountId": "wsb-account-123",
  "cardId": "card-12345678",
  "cardholderId": "ch-12345678",
  "transactionId": "tx-12345678",
  "workOrderId": "wo-12345678",
  "status": "COMPLETED",
  "result": "SUCCESS",
  "data": {},
  "errorMessage": "Insufficient funds",
  "errorCode": "INSUFFICIENT_FUNDS",
  "retryCount": 0,
  "maxRetries": 3
}
'
{
  "success": true,
  "code": 200,
  "msg": "Success",
  "eventId": "evt-12345678",
  "processingTime": 1640995200000
}

Headers

​
X-WSB-SIGNATURE
string

FinCard platform signature

Body

application/json

Webhook event data

Webhook event data

​
eventType
string

Event type

Example:

"CARD_OPERATION_TRANSACTION"

​
eventId
string

Event ID

Example:

"evt-12345678"

​
timestamp
integer<int64>

Timestamp

Example:

1640995200000

​
tenantId
string

Tenant ID

Example:

"wsb-12345678"

​
accountId
string

Account ID

Example:

"wsb-account-123"

​
cardId
string

Card ID (for card events)

Example:

"card-12345678"

​
cardholderId
string

Cardholder ID (for cardholder events)

Example:

"ch-12345678"

​
transactionId
string

Transaction ID (for transaction events)

Example:

"tx-12345678"

​
workOrderId
string

Work order ID (for work order events)

Example:

"wo-12345678"

​
status
string

Event status

Example:

"COMPLETED"

​
result
string

Event result

Example:

"SUCCESS"

​
data
object

Event data payload

​
errorMessage
string

Error message (if any)

Example:

"Insufficient funds"

​
errorCode
string

Error code (if any)

Example:

"INSUFFICIENT_FUNDS"

​
retryCount
integer<int32>

Retry count

Example:

0

​
maxRetries
integer<int32>

Max retries

Example:

3

Response

Webhook processed successfully

Webhook callback response

​
success
boolean

Success flag

Example:

true

​
code
integer<int32>

Response code

Example:

200

​
msg
string

Response message

Example:

"Success"

​
eventId
string

Processed event ID

Example:

"evt-12345678"

​
processingTime
integer<int64>

Processing time

Example:

1640995200000