Currency Conversion (MCC)

POST/api/conversion/mcc

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

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

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Request Body

Name	Type	Description
`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.

Response

Name	Type	Description
`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.

Status Codes

`200`	Currency conversion calculated successfully.
`400`

Request

curl --request POST \
  --url https://pluraluat.v2.pinepg.in/api/conversion/mcc \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "bank_code": "AXIS",
  "invoice_id": "INV-20250716-001",
  "source_currency": "840",
  "dest_currency": "356",
  "transaction_amount": "100"
}'

Run this request

Bearer token

Request body (JSON)

200 OK

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