Валютный конвертер

Конвертер валют позволяет определить эквивалент исходной суммы транзакции в нужной валюте по источнику валютных курсов, доступному в настройках конвертера.

В контексте конвертации, валюта транзакции называется исходной валютой, а валюта, в которую конвертируется сумма транзакции – целевой валютой.

Конвертер позволяет выставлять покупателю счет в валюте, которая не поддерживается эквайером торговца. Также конвертер позволяет сконвертировать валюту транзакции в другую валюту шлюза и получить сконвертированную сумму в ответе на транзакцию или в автоматическом уведомлении, не используя ее при этом в транзакции с эквайером.

Сконвертированная сумма также будет доступна в отчете и на странице детальной информации о транзакции.

Конвертер может быть использован для следующих типов транзакций: оплата, выплата, авторизация, возврат средств, списание средств и отмена авторизации как в интеграциях через виджет, так и при прямых запросах.

Для транзакций типа возврат будет применен курс, использованный для соответствующей оплаты; для транзакций отмены авторизации и списания средств будет использован курс соответствующей транзакции авторизации.

Обратитесь к своему менеджеру или в службу поддержки для настройки конвертера.

Секция conversion

Секция conversion будет отправлена в синхронном ответе на запрос транзакции, в ответе на запрос статуса транзакции и в автоматическом уведомлении, если на шлюзе, использованном для обработки транзакции настроен конвертер.

Параметр	Тип данных	Описание
transaction	object
conversion	object	Секция информации о конвертации.
converted_amount	bigInteger	Сумма транзакции в целевой валюте в минимальных денежных единицах, сконвертированная сумма.
converted_currency	string	Целевая валюта в формате ISO-4217 alpha-3 code.
exchange_rate	object
:{base currency}_TO_{quote-currency}	float	Валютный курс, использованный для конвертации = единица исходной валюты ÷ единица целевой валюты.
exchange_rate_date	string	Дата загрузки обменного курса с источника курса валют в формате YYYY-MM-DDThh:mm:ss[.SSSSSS]Z.

Пример ответа на запрос оплаты с секцией conversion

{
    "transaction": {
        "uid": "263586a3-50f6-4ff3-b9a0-ba5bd8f71b9d",
        "status": "successful",
        "amount": 700,
        "currency": "GBP",
        "description": "Test transaction",
        "type": "payment",
        "payment_method_type": "credit_card",
        "tracking_id": "tracking_id_000",
        "message": "Successfully processed",
        "test": true,
        "created_at": "2025-03-11T09:13:07.536Z",
        "updated_at": "2025-03-11T09:13:12.880Z",
        "paid_at": "2025-03-11T09:13:12.848Z",
        "expired_at": null,
        "recurring_type": null,
        "closed_at": null,
        "settled_at": null,
        "manually_corrected_at": null,
        "language": "en",
        "credit_card": {
            "holder": "John Doe",
            "stamp": "a282993adc1299dacc79248e77e04c2995f79fcc9f82f408bec59ba20ff55739",
            "brand": "master",
            "last_4": "5003",
            "first_1": "5",
            "bin": "520424",
            "bin_8": "52042400",
            "issuer_country": null,
            "issuer_name": null,
            "product": null,
            "exp_month": 10,
            "exp_year": 2027,
            "token_provider": null,
            "token": null
        },
        "receipt_url": "https://online.unonapay.com/customer/transactions/263586a3-50f6-4ff3-b9a0-ba5bd8f71b9d/c40a0033665f6fb8e7608c8a285644215802fb461288ec2e324bf507e045a9cd?language=en",
        "status_code": null,
        "gateway": {
            "iframe": true
        },
        "mute_notifications": null,
        "version": 5,
        "psp_settled_at": null,
        "registry_id": null,
        "id": "263586a3-50f6-4ff3-b9a0-ba5bd8f71b9d",
        "additional_data": {},
        "redirect_url": "https://gateway.unonapay.com/process/263586a3-50f6-4ff3-b9a0-ba5bd8f71b9d",
        "code": "S.0000",
        "friendly_message": "The transaction is successfully processed.",
        "smart_routing_verification": {
            "status": "successful"
        },
        "conversion": {
            "converted_amount": 829,
            "converted_currency": "EUR",
            "exchange_rate": {
                "GBP_TO_EUR": 1.1843844993153705
            },
            "exchange_rate_date": "2025-03-11T09:03:07.978633Z"
        },
        "payment": {
            "auth_code": "654321",
            "bank_code": "05",
            "rrn": "999",
            "ref_id": "777888",
            "message": "Payment was approved",
            "amount": 700,
            "currency": "GBP",
            "billing_descriptor": "test descriptor",
            "gateway_id": 71839,
            "status": "successful"
        },       
        "customer": {
            "ip": null,
            "email": null,
            "device_id": "",
            "birth_date": "",
            "external_id": null
        },
        "billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "address": "",
            "country": "GB",
            "city": "London",
            "zip": "",
            "state": "",
            "phone": ""
        }
    }
}