Валютный конвертер
Конвертер валют позволяет определить эквивалент исходной суммы транзакции в нужной валюте по источнику валютных курсов, доступному в настройках конвертера.
В контексте применяемого валютного курса валюта транзакции является базовой валютой курса, а валюта конвертации (converted_currency) — котируемой валютой курса.
Конвертер позволяет выставлять покупателю счет в валюте, которая не поддерживается эквайером торговца. Также конвертер позволяет сконвертировать валюту транзакции в другую валюту шлюза и получить сконвертированную сумму в ответе на транзакцию или в автоматическом уведомлении, не используя её при этом в транзакции с эквайером.
Сконвертированная сумма также будет доступна в отчете и на странице детальной информации о транзакции.
Конвертер может быть использован для следующих типов транзакций: оплата, выплата, авторизация, возврат средств, списание средств и отмена авторизации как в интеграциях через виджет, так и при прямых запросах.
Для транзакций типа возврат будет применен курс, использованный для соответствующей оплаты; для транзакций отмены авторизации и списания средств будет использован курс соответствующей транзакции авторизации.
Обратитесь к своему менеджеру или в службу поддержки для настройки конвертера.
Секция conversion
Секция conversion будет отправлена в синхронном ответе на запрос транзакции, в ответе на запрос статуса транзакции и в автоматическом уведомлении, если на шлюзе, использованном для обработки транзакции настроен конвертер.
|
|||||||||||||||||||||||
Пример ответа на запрос оплаты с секцией conversion
{
"transaction": {
"uid": "d6f8180e-559b-4662-8509-a60083326e4f",
"status": "successful",
"amount": 70,
"currency": "EUR",
"description": "Test transaction",
"type": "payment",
"payment_method_type": "credit_card",
"tracking_id": "tracking_id_000",
"message": "Транзакция успешна.",
"test": true,
"created_at": "2026-01-11T20:50:33.326Z",
"updated_at": "2026-01-11T20:50:40.075Z",
"paid_at": "2026-01-11T20:50:40.008Z",
"expired_at": null,
"recurring_type": null,
"closed_at": null,
"settled_at": null,
"manually_corrected_at": null,
"language": "ru",
"credit_card": {
"holder": "John Doe",
"stamp": "d1c853d9d6623ad497d6df0f90b92d19ae8393913b17198ac6006bdc2700485a",
"brand": "visa",
"last_4": "0000",
"first_1": "4",
"bin": "420000",
"bin_8": "42000000",
"issuer_country": "US",
"issuer_name": "VISA Demo Bank",
"product": "F",
"exp_month": 10,
"exp_year": 2028,
"token_provider": null,
"token": null
},
"receipt_url": "https://demo-backoffice.begateway.com/customer/transactions/d6f8180e-559b-4662-8509-a60083326e4f/db5bb9124efe90cb506d87e49e4781df566e6d7f6603c6f7e0f70d162db064dd?language=ru",
"status_code": null,
"gateway": {
"iframe": true
},
"mute_notifications": null,
"version": 3,
"psp_settled_at": null,
"registry_id": null,
"three_ds_expired_at": null,
"id": "d6f8180e-559b-4662-8509-a60083326e4f",
"redirect_url": "https://demo-gateway.begateway.com/process/d6f8180e-559b-4662-8509-a60083326e4f",
"code": "S.0000",
"friendly_message": "Транзакция проведена успешно.",
"conversion": {
"converted_amount": 81,
"converted_currency": "USD",
"exchange_rate": {
"EUR_TO_USD": 1.1641075001251164
},
"exchange_rate_ids": [
1985952
],
"exchange_rate_date": "2026-01-11T20:03:02.932966Z"
},
"payment": {
"auth_code": "654321",
"bank_code": "05",
"rrn": "999",
"ref_id": "777888",
"message": "Payment was approved",
"amount": 70,
"currency": "EUR",
"billing_descriptor": "TEST GATEWAY BILLING DESCRIPTOR",
"gateway_id": 3549,
"status": "successful"
},
"avs_cvc_verification": {
"avs_verification": {
"result_code": "1"
},
"cvc_verification": {
"result_code": "1"
}
},
"customer": {
"ip": null,
"email": null,
"device_id": null,
"birth_date": null,
"external_id": null
},
"billing_address": {
"first_name": null,
"last_name": null,
"middle_name": null,
"address": null,
"country": null,
"city": null,
"zip": null,
"state": null,
"phone": null
}
}
}