Skip to main content

​
Webhook Description

Webhook NameDescriptionRequest Type
card_transactionCallback notification for user consumption orders. This notification will be sent when PowerCard receives merchant’s consumption information.POST

​
Response Example

{
  "eventType": "card_transaction",
  "data": "xxxxxx",
  "key": "xxxxxx"
}

​
Field Description

Field NameRequiredTypeDescriptionExample ValueNote
powerCardIdYesstringPowerCard IDa9f4cb3bfa8649b88853eded3ad853dd
createTimeYesint64Transaction creation time
transactionYesTransactionConsumption information
authTransactionYesTransactionAuthorization information
holdRefundYesTransactionPre-authorization refund order

​
Transaction Structure

Field NameRequiredTypeDescriptionExample ValueNote
transNoYesstringPowerCard transaction order numbera9f4cb3bfa8649b88853eded3ad853dd
oriTransNoYesnumberOriginal order number
settlementCurrencyYesstringSettlement currency
settlementAmountYesObjectSettlement amount
transCurrencyYesstringTransaction currency
transAmountYesnumberTransaction amount
handlingFeeYesnumberHandling fee
handlingFeeCurrencyYesstringHandling fee currency
transStatusYesstringTransaction status
remarkNostringRemark
transTypeYesstringTransaction type
transTimeYesnumberTransaction time
merchantNameYesstringMerchant name
refundAmountDiffNonumberDifference due to exchange rate changes when refunding

​
Data Example

{
  "powerCardId": "1396041e48304c64842b920391c8d35a",
  "createTime": 1743057837618,
  "transaction": {
    "handlingFee": 0,
    "handlingFeeCurrency": "USD",
    "merchantName": "DISCORD* NITROBASIC-MO",
    "remark": "VISA 40085 US",
    "settlementAmount": -2.99,
    "settlementCurrency": "USD",
    "transAmount": -2.99,
    "transCurrency": "USD",
    "transNo": "250327530370001",
    "transStatus": "approved",
    "transTime": 1743057837618,
    "transType": "purchase"
  }
}