Feature Requests
Under Review

Feature Request – Include Net Receivable Amount & Currency Conversion Support in “Get Payment Details” API

Hi Dodo Payments Team,

I would like to request an enhancement to the Get Payment Details API.

Currently, the API provides basic payment information, but it does not include the net amount that will be credited to our bank account after deducting all fees (Dodo commission, payment gateway charges) and applicable taxes.

For applications like ours—where accurate wallet crediting, reconciliation, and automated accounting are essential—we need a reliable, programmatic way to determine the net receivable amount for each payment.

Requested Features

1. Add Net Receivable Amount to API Response

Please include in the API response:

  • net_receivable_amount — the final amount settled to the merchant after all deductions.

Optional but highly useful breakdown fields:

  • platform_fee
  • payment_gateway_fee

This would remove ambiguity and enable seamless financial reconciliation.

2. Support for Currency Conversion in API Response

Our application logic and all internal wallet balances operate in USD. Therefore, if a payment is made in another currency, we need the net receivable amount in USD.

To simplify this, we request the ability to specify the desired output currency in the API request. For example:

`GET /payments/{payment_id}?output_currency=USD `

If implemented, the API response could include:

  • net_receivable_amount_original_currency
  • net_receivable_amount_converted
  • converted_currency
  • conversion_rate_used

This would eliminate the need for us to manually fetch forex rates and perform conversions, ensuring consistency and reducing engineering overhead.

Why This Is Important

  • Ensures accurate wallet crediting
  • Simplifies multi-currency accounting
  • Reduces dependency on external forex APIs
  • Improves developer experience
  • Prevents calculation errors in reconciliation workflows

0 Comments

Sign in to comment

No comments yet. Be the first to share your thoughts!