Requote webhooks

Sell transaction requote required webhook

Overview

The sell_transaction_requote_required webhook notifies partners when a sell transaction requires a requote due to price changes or other market conditions. This webhook enables partners to surface requote notifications in-app, providing a better user experience than email-only notifications. Webhook Type: sell_transaction_requote_required Full payload schema: sell_transaction_requote_required reference

Use case

When a sell transaction requires a requote, users traditionally receive only an email notification. This approach has several limitations:

Users may not check their email immediately
Email notifications can be missed or filtered to spam
There’s no in-app acknowledgment of the requote

By subscribing to this webhook, partners can:

Display in-app notifications when requotes occur
Prompt users to accept new quotes within your application
Provide a smooth, high-intent user experience
Reduce transaction abandonment due to missed requotes

Webhook payload

The webhook delivers the full Sell transaction object under data, with status set to requoteRequired — the same payload shape as the other sell_transaction_* events. The example below is truncated to the fields most relevant to handling a requote.

Example payload (truncated)

{
  "type": "sell_transaction_requote_required",
  "data": {
    "id": "b8606f16-5518-4425-8076-87067a291ddf",
    "status": "requoteRequired",
    "createdAt": "2026-02-13T10:30:00.000Z",
    "updatedAt": "2026-02-13T11:45:00.000Z",
    "baseCurrencyAmount": 1000.0,
    "quoteCurrencyAmount": 950.0,
    "quoteExpiresAt": "2026-02-13T11:50:00.000Z",
    "baseCurrency": { "code": "usdc", "type": "crypto" },
    "quoteCurrency": { "code": "usd", "type": "fiat" },
    "externalCustomerId": "customer_123",
    "externalTransactionId": "your_transaction_id"
  }
}

Field descriptions

Field	Type	Description
`type`	string	Always `sell_transaction_requote_required` for this webhook
`data.id`	string	MoonPay transaction identifier
`data.status`	string	Transaction status (will be `requoteRequired`)
`data.createdAt`	string (ISO 8601)	Timestamp when the transaction was created
`data.updatedAt`	string (ISO 8601)	Timestamp when the requote was triggered
`data.baseCurrencyAmount`	number	Amount of cryptocurrency to sell
`data.quoteCurrencyAmount`	number	Updated fiat amount the user will receive
`data.quoteExpiresAt`	string (ISO 8601)	Time at which the new quote expires
`data.baseCurrency`	object	Cryptocurrency being sold; `code` holds the currency code (e.g. `usdc`)
`data.quoteCurrency`	object	Fiat currency being paid out; `code` holds the currency code (e.g. `usd`)
`data.externalCustomerId`	string	Your customer identifier (if provided)
`data.externalTransactionId`	string	Your transaction identifier (if provided)

The full field list is documented on the reference page.

Subscribing to the webhook

To receive sell_transaction_requote_required webhooks:

Configure your webhook endpoint in the MoonPay Dashboard or via API.
Add the webhook type to your subscription:
- Navigate to Settings → Webhooks in your MoonPay Dashboard
- Select sell_transaction_requote_required from the available webhook types
- Make sure your endpoint is configured to handle POST requests
Verify your endpoint is properly configured and can receive webhooks.

Implementation guidelines

Webhook receipt

Your endpoint should:

Respond with a 200 OK status code within 5 seconds
Process the webhook asynchronously if needed
Implement idempotency (handle duplicate webhook deliveries)

User notification

When receiving this webhook:

Display an in-app notification to the user
Show the updated quoteCurrencyAmount clearly
Provide a clear call-to-action to accept or decline the new quote
Include a timeout/expiration time for the requote

User action

Allow users to:

Accept the new quote and continue the transaction
Decline and cancel the transaction
View the price difference between original and requoted amounts

Security

Verify webhook signatures to confirm authenticity (see Webhook security section)
Use HTTPS endpoints only
Validate the webhook payload structure before processing

Testing

Sandbox environment

Test the webhook in the MoonPay sandbox environment before going live:

Use sandbox API keys from your MoonPay Dashboard
Configure your webhook endpoint to receive sandbox webhooks
Trigger test requotes to verify your implementation

Verification checklist

Webhook endpoint responds with 200 OK
In-app notification displays correctly
User can accept the new quote
User can decline the requote
Idempotency is handled properly
Webhook signature verification is implemented

Other sell transaction webhooks you may want to subscribe to:

sell_transaction_created – When a sell transaction is initiated
sell_transaction_updated – When a sell transaction’s status or details change, including completion
sell_transaction_failed – When a sell transaction fails

Support

For questions or issues with this webhook:

Email: support@moonpay.com

Get Started

On-Ramp

Off-Ramp

Sell transaction requote required webhook

Overview

Use case

Webhook payload

Field descriptions

Subscribing to the webhook

Implementation guidelines

Testing

Sandbox environment

Verification checklist

Support

​Sell transaction requote required webhook

​Overview

​Use case

​Webhook payload

​Field descriptions

​Subscribing to the webhook

​Implementation guidelines

​Testing

​Sandbox environment

​Verification checklist

​Related webhooks

​Support

Sell transaction requote required webhook

Overview

Use case

Webhook payload

Field descriptions

Subscribing to the webhook

Implementation guidelines

Testing

Sandbox environment

Verification checklist

Related webhooks

Support