From c9d06e177f0339fa8330c17348fcabc20951df8c Mon Sep 17 00:00:00 2001
From: Aaryaman Bhute <aaryaman@lightspark.com>
Date: Mon, 29 Jun 2026 16:35:09 +0000
Subject: [PATCH] docs(openapi): correct exchangeRate example to match
 documented basis (PROD-54)

The exchangeRate field on the /exchange-rates ExchangeRate schema is documented
as 'Number of sending currency units per receiving currency unit', but the
examples showed destination-per-source values (USD->INR 82.50, USD->EUR 0.925),
the inverse of both the field description and the live API.

Correct the examples to the documented basis (sending units per receiving unit)
and keep each response example internally consistent with its sendingAmount and
receivingAmount: USD->INR 0.012121 (= 1/82.50, $100 -> 8250 INR), USD->EUR
1.081081 (= 1/0.925, $100 -> 92.50 EUR, receivingAmount 18500 -> 9250).
---
 mintlify/openapi.yaml                                     | 8 ++++----
 openapi.yaml                                              | 8 ++++----
 .../components/schemas/exchange_rates/ExchangeRate.yaml   | 2 +-
 openapi/paths/exchange-rates/exchange_rates.yaml          | 6 +++---
 4 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml
index 08333ad96..d93a10d11 100644
--- a/mintlify/openapi.yaml
+++ b/mintlify/openapi.yaml
@@ -229,7 +229,7 @@ paths:
                           symbol: ₹
                         destinationPaymentRail: UPI
                         receivingAmount: 825000
-                        exchangeRate: 82.5
+                        exchangeRate: 0.012121
                         fees:
                           fixed: 100
                           total: 150
@@ -248,8 +248,8 @@ paths:
                           name: Euro
                           symbol: €
                         destinationPaymentRail: SEPA_INSTANT
-                        receivingAmount: 18500
-                        exchangeRate: 0.925
+                        receivingAmount: 9250
+                        exchangeRate: 1.081081
                         fees:
                           fixed: 10
                           total: 15
@@ -9260,7 +9260,7 @@ components:
           type: number
           description: Number of sending currency units per receiving currency unit.
           exclusiveMinimum: 0
-          example: 82.5
+          example: 0.012121
         fees:
           $ref: '#/components/schemas/ExchangeRateFees'
         updatedAt:
diff --git a/openapi.yaml b/openapi.yaml
index 08333ad96..d93a10d11 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -229,7 +229,7 @@ paths:
                           symbol: ₹
                         destinationPaymentRail: UPI
                         receivingAmount: 825000
-                        exchangeRate: 82.5
+                        exchangeRate: 0.012121
                         fees:
                           fixed: 100
                           total: 150
@@ -248,8 +248,8 @@ paths:
                           name: Euro
                           symbol: €
                         destinationPaymentRail: SEPA_INSTANT
-                        receivingAmount: 18500
-                        exchangeRate: 0.925
+                        receivingAmount: 9250
+                        exchangeRate: 1.081081
                         fees:
                           fixed: 10
                           total: 15
@@ -9260,7 +9260,7 @@ components:
           type: number
           description: Number of sending currency units per receiving currency unit.
           exclusiveMinimum: 0
-          example: 82.5
+          example: 0.012121
         fees:
           $ref: '#/components/schemas/ExchangeRateFees'
         updatedAt:
diff --git a/openapi/components/schemas/exchange_rates/ExchangeRate.yaml b/openapi/components/schemas/exchange_rates/ExchangeRate.yaml
index 7c24ca289..61f973659 100644
--- a/openapi/components/schemas/exchange_rates/ExchangeRate.yaml
+++ b/openapi/components/schemas/exchange_rates/ExchangeRate.yaml
@@ -49,7 +49,7 @@ properties:
     type: number
     description: Number of sending currency units per receiving currency unit.
     exclusiveMinimum: 0
-    example: 82.50
+    example: 0.012121
   fees:
     $ref: ./ExchangeRateFees.yaml
   updatedAt:
diff --git a/openapi/paths/exchange-rates/exchange_rates.yaml b/openapi/paths/exchange-rates/exchange_rates.yaml
index 4c30208c2..ef072fd46 100644
--- a/openapi/paths/exchange-rates/exchange_rates.yaml
+++ b/openapi/paths/exchange-rates/exchange_rates.yaml
@@ -73,7 +73,7 @@ get:
                       symbol: "₹"
                     destinationPaymentRail: UPI
                     receivingAmount: 825000
-                    exchangeRate: 82.50
+                    exchangeRate: 0.012121
                     fees:
                       fixed: 100
                       total: 150
@@ -92,8 +92,8 @@ get:
                       name: Euro
                       symbol: "€"
                     destinationPaymentRail: SEPA_INSTANT
-                    receivingAmount: 18500
-                    exchangeRate: 0.925
+                    receivingAmount: 9250
+                    exchangeRate: 1.081081
                     fees:
                       fixed: 10
                       total: 15