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

# Simulate refund webhook

> Simulate a card refund webhook event for testing.

Simulates a card refund webhook notification for testing. Refunds the most recently cleared transaction on the card. Available in non-production environments only. Requires an API key with access level 2 or higher.

## Body

<ParamField body="card_id" type="string" required>
  Card identifier to simulate the refund against.
</ParamField>

<ParamField body="bill_amount" type="number" required>
  Amount to refund in USD.
</ParamField>

## Response

Returns HTTP 201 with an empty body on success.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.cryptomate.me/cards/webhook/simulate/refund" \
    -H "x-api-key: $CRYPTOMATE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "card_id": "aBcD1efGh2iJkL3mnOpQ4rStUvWxYz56",
      "bill_amount": 100.00
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 404 Cleared Transaction Not Found theme={null}
  {
    "code": "NOT_FOUND",
    "message": "Cleared transaction not found for card aBcD1efGh2iJkL3mnOpQ4rStUvWxYz56"
  }
  ```
</ResponseExample>