# Currency Conversion (MCC)

**Method:** `POST`

**Path:** `/api/conversion/mcc`

**Category:** International Payments

**Authentication:** Required

## Description

Calculates accurately converted amounts for cross-border transactions
using Multi-Currency Conversion (MCC).

Supports 50+ currencies with a robust Fraud Risk Management engine.


## Request Body

Content-Type: `application/json`

- `bank_code` (`string`) **required** — Bank code for the conversion.
- `invoice_id` (`string`) **required** — Unique invoice reference for the conversion request.
- `source_currency` (`string`) **required** — Numeric ISO 4217 code for the source currency (3 digits).
- `dest_currency` (`string`) **required** — Numeric ISO 4217 code for the destination currency (3 digits).
- `transaction_amount` (`string`) **required** — The transaction amount to convert.

### Example Request

```json
{
  "bank_code": "AXIS",
  "invoice_id": "INV-20250716-001",
  "source_currency": "840",
  "dest_currency": "356",
  "transaction_amount": "100"
}
```

## Responses

- `200` — Currency conversion calculated successfully.
- `400` — 

### Response Schema

- `source_currency` (`string`) — Numeric ISO 4217 source currency code.
- `dest_currency` (`string`) — Numeric ISO 4217 destination currency code.
- `invoice_id` (`string`) — Invoice reference from the request.
- `conversion_rate` (`number`) — Rate used to convert source to destination currency.
- `converted_amount` (`integer`) — Final amount after conversion and exponent adjustment.
- `transaction_amount` (`string`) — Original transaction amount.
- `converted_exponent` (`integer`) — Number of decimal places applied during conversion.

### Example Response

```json
{
  "source_currency": "840",
  "dest_currency": "356",
  "invoice_id": "INV-20250716-001",
  "conversion_rate": 86.74531575294934,
  "converted_amount": 8674,
  "transaction_amount": "100",
  "converted_exponent": 2
}
```

---

Reference: https://localhost:3000/api/international-payments/currency-conversion