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

Please authenticate to join the conversation.

Upvoters
Status

In Review

Board
💡

Feature Request

Date

3 months ago

Author

Arnav Singh

Subscribe to post

Get notified by email when there are changes.