> ## Documentation Index
> Fetch the complete documentation index at: https://pwapi.uuwallet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CARD_TRANSACTION

### Webhook Description

| Webhook Name      | Description                                                                                                                                   | Request Type |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| card\_transaction | Callback notification for user consumption orders. This notification will be sent when PowerCard receives merchant's consumption information. | POST         |

### Response Example

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

### Field Description

| Field Name      | Required | Type        | Description                    | Example Value                    | Note |
| --------------- | -------- | ----------- | ------------------------------ | -------------------------------- | ---- |
| powerCardId     | Yes      | string      | PowerCard ID                   | a9f4cb3bfa8649b88853eded3ad853dd |      |
| createTime      | Yes      | int64       | Transaction creation time      |                                  |      |
| transaction     | Yes      | Transaction | Consumption information        |                                  |      |
| authTransaction | Yes      | Transaction | Authorization information      |                                  |      |
| holdRefund      | Yes      | Transaction | Pre-authorization refund order |                                  |      |

### Transaction Structure

| Field Name          | Required | Type   | Description                                            | Example Value                    | Note |
| ------------------- | -------- | ------ | ------------------------------------------------------ | -------------------------------- | ---- |
| transNo             | Yes      | string | PowerCard transaction order number                     | a9f4cb3bfa8649b88853eded3ad853dd |      |
| oriTransNo          | Yes      | number | Original order number                                  |                                  |      |
| settlementCurrency  | Yes      | string | Settlement currency                                    |                                  |      |
| settlementAmount    | Yes      | Object | Settlement amount                                      |                                  |      |
| transCurrency       | Yes      | string | Transaction currency                                   |                                  |      |
| transAmount         | Yes      | number | Transaction amount                                     |                                  |      |
| handlingFee         | Yes      | number | Handling fee                                           |                                  |      |
| handlingFeeCurrency | Yes      | string | Handling fee currency                                  |                                  |      |
| transStatus         | Yes      | string | Transaction status                                     |                                  |      |
| remark              | No       | string | Remark                                                 |                                  |      |
| transType           | Yes      | string | Transaction type                                       |                                  |      |
| transTime           | Yes      | number | Transaction time                                       |                                  |      |
| merchantName        | Yes      | string | Merchant name                                          |                                  |      |
| refundAmountDiff    | No       | number | Difference due to exchange rate changes when refunding |                                  |      |

### Data Example

```json
{
  "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"
  }
}
```