transaction_failed

Sent when a Buy transaction fails.

WEBHOOK transaction_failed

Example

{
  "type": "transaction_failed",
  "data": {
    "id": "defb7c52-7bd3-422b-9052-374df50cc51a",
    "createdAt": "2024-02-17T18:24:45.206Z",
    "updatedAt": "2024-02-17T18:24:45.206Z",
    "quoteExpiresAt": "2024-02-17T18:54:45.206Z",
    "baseCurrencyAmount": 45.5,
    "quoteCurrencyAmount": 0.0154,
    "feeAmount": 1.7,
    "extraFeeAmount": 0.43,
    "paymentMethod": "credit_debit_card",
    "networkFeeAmount": 2.37,
    "areFeesIncluded": true,
    "status": "completed",
    "failureReason": null,
    "walletAddress": "0xc216eD2D6c295579718dbd4a797845CdA70B3C36",
    "walletAddressTag": null,
    "cryptoTransactionId": "0x6751c8fce2e0fb5d57bb4801b31b35a7160fa362e0c5703d44cfd508317ee2f8",
    "redirectUrl": "https://api.moonpay.com/secure/url?transactionId=defb7c52-7bd3-422b-9052-374df50cc51a",
    "returnUrl": "https://buy.moonpay.com/transaction_receipt?transactionId=defb7c52-7bd3-422b-9052-374df50cc51a",
    "widgetRedirectUrl": null,
    "eurRate": 0.92432,
    "usdRate": 1,
    "gbpRate": 0.79016,
    "currencyId": "8d305f63-1fd7-4e01-a220-8445e591aec4",
    "currency": {
      "id": "aaefa32f-161b-42c8-8115-debcbf3d6a2d",
      "createdAt": "2019-05-17T18:24:45.206Z",
      "updatedAt": "2019-05-17T18:24:45.206Z",
      "type": "crypto",
      "name": "USD Coin (ERC-20)",
      "code": "usdc",
      "precision": 2,
      "minBuyAmount": 30,
      "maxBuyAmount": 1000,
      "minSellAmount": 15,
      "maxSellAmount": 100000,
      "addressRegex": "^(0x)[0-9A-Fa-f]{40}$",
      "testnetAddressRegex": "^(0x)[0-9A-Fa-f]{40}$",
      "supportsAddressTag": false,
      "addressTagRegex": null,
      "supportsTestMode": true,
      "isSuspended": false,
      "isSupportedInUs": true,
      "isSellSupported": true,
      "notAllowedUSStates": [
        "LA",
        "VI"
      ],
      "notAllowedCountries": [
        "CA"
      ],
      "metadata": {
        "contractAddress": "0x0000000000000000000000000000000000000000",
        "chainId": "1",
        "networkCode": "ethereum"
      }
    },
    "baseCurrencyId": "edd81f1f-f735-4692-b410-6def107f17d2",
    "baseCurrency": {
      "id": "6f424585-8936-4eb1-b01e-443fb306d1f5",
      "createdAt": "2019-05-17T18:24:45.206Z",
      "updatedAt": "2019-05-17T18:24:45.206Z",
      "type": "fiat",
      "name": "Pound Sterling",
      "code": "gbp",
      "precision": 2,
      "minBuyAmount": 30,
      "maxBuyAmount": 9000,
      "isSellSupported": true
    },
    "customerId": "77cc1309-0058-4177-b170-8e9657fe12eb",
    "cardId": "0a7e23d8-6a52-44c7-b189-91b37bd13796",
    "bankAccountId": null,
    "externalCustomerId": "<string>",
    "externalTransactionId": "<string>",
    "country": "GBR",
    "state": null,
    "isFromQuote": true,
    "isRecurring": true,
    "isTicketPayment": true,
    "flow": "principal",
    "bankTransferReference": "<string>",
    "bankDepositInformation": {},
    "feeAmountDiscount": 123,
    "extraFeeAmountDiscount": 123,
    "nftTransaction": {},
    "nftToken": {},
    "stages": [
      {
        "actions": [
          {
            "type": "<string>",
            "url": "<string>"
          }
        ],
        "failureReason": "<string>"
      }
    ],
    "cardType": "card",
    "cardPaymentType": "credit"
  },
  "externalCustomerId": "<string>"
}

Headers

Moonpay-Signature · string · required

Legacy signature: t=<unix timestamp>,s=<signature> where the signature is an HMAC-SHA256 of <timestamp>.<request body> keyed with the endpoint's signing secret. Prefer Moonpay-Signature-V2.

Moonpay-Signature-V2 · string · required

Signature to verify the event was sent by MoonPay: t=<unix timestamp>,s=<signature> where the signature is an HMAC-SHA256 of <timestamp>.<request body> keyed with your account's webhook API key. See Request signing.

Body

application/json

type · enum<string> · required

The event type.

Available options: transaction_failed

data · object · required

The Buy transaction object as delivered in webhook events. Matches the Get Buy transaction response, plus webhook-only fields such as stages, cardType and nftToken.

Show child attributes

externalCustomerId · string | null

An identifier associated with the customer, provided by you. Also present inside data.

Response

200

Return any 2xx status code within 5 seconds to acknowledge receipt. Non-2xx responses, timeouts and connection errors are retried with exponential backoff.