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 →

Header Parameters

Field	Details
`Request-Timestamp` `string`date-time	ISO 8601 UTC timestamp of the request. Used for idempotency and audit.
`Request-ID` `string`	Use a global unique identifier [GUID] for the request. Constraints Minimum length: 1 characterMaximum length: 50 characters

Request Bodyrequired

Field	Details
`bank_code` `string`required	Bank code for the conversion.
`invoice_id` `string`required	Unique invoice reference for the conversion request. Constraints Minimum length: 1 character
`source_currency` `string`required	Numeric ISO 4217 code for the source currency (3 digits). Constraints Minimum length: 3 charactersMaximum length: 3 characters
`dest_currency` `string`required	Numeric ISO 4217 code for the destination currency (3 digits). Constraints Minimum length: 3 charactersMaximum length: 3 characters
`transaction_amount` `string`required	The transaction amount to convert.

Response

Field	Details
`source_currency` `string`	Numeric ISO 4217 source currency code. Constraints Minimum length: 3 charactersMaximum length: 3 characters
`dest_currency` `string`	Numeric ISO 4217 destination currency code. Constraints Minimum length: 3 charactersMaximum length: 3 characters
`invoice_id` `string`	Invoice reference from the request.
`conversion_rate` `number`double	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`	The request was malformed or missing required fields.

Run

Request

curl --request POST \
  --url https://pluraluat.v2.pinepg.in/api/conversion/mcc \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z' \
  --data '{
  "bank_code": "AXIS",
  "invoice_id": "INV-20250716-001",
  "source_currency": "840",
  "dest_currency": "356",
  "transaction_amount": "100"
}'

Status:

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