Skip to main content
POST
Webhook Callback

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