Announcement: Enhancements to Checkout Payments and Deposits Webhooks

What’s New?

1. New Fields in Both Webhooks

• received_amount: The total crypto amount you receive after blockchain fees and BlockBee’s service fee.
• received_amount_fiat: The fiat equivalent of the received amount, based on the merchant’s chosen currency.
• type: Indicates the webhook type (payment or deposit).

2. Fields Specific to Each Webhook

• Checkout Payments: Now includes paid_amount_fiat, representing the exact fiat value of the paid amount as selected by the merchant.
• Checkout Deposits: Now includes exchange_rate, providing direct visibility into the rate used for currency conversion.

Note: These fields already existed on the opposite webhook—exchange_rate was available for Checkout Payments, and paid_amount_fiat was available for Checkout Deposits. We’ve simply aligned both webhooks so you can enjoy consistent data for easier reconciliation and reporting.

Why These Changes Matter

• Clearer Transaction Details: You can now see exactly how much ends up in your wallet, both in crypto and fiat, after all fees.
• Improved Accounting & Reporting: The new type field, combined with fiat values and exchange rates, simplifies record-keeping and financial analysis.
• Better Transparency: More data points in your webhook payload mean greater visibility into how amounts are calculated and converted.

Next Steps

• Update Your Integrations: Check the newly available fields (received_amount, received_amount_fiat, type, paid_amount_fiat, and exchange_rate) and ensure your systems are ready to handle them.
• Review Documentation: Visit our developer documentation to learn more about how to integrate and best utilize these new webhook fields.

Thank you for choosing BlockBee. We remain committed to improving our platform to help you manage your crypto payments and deposits with maximum transparency and efficiency. If you have any questions or feedback regarding these new fields, please don’t hesitate to reach out to our support team.