Шаг 2. Получение обменного курса для клиента

На этом шаге выполняется расчет курса обмена и определение конечной стоимости для клиента.

В качестве параметров запроса передается базовая валюта (валюта клиента) и валюта получателя. В некоторых случаях дополнительно необходимо передать тип платежного метода — подробнее в разделе «Платежные методы».

Запрос:

curl -X POST https://api.creon.ae/v2/rate \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{"currency_from":"RUB", "currency_to": "AZN", "amount": 1000.25}'

Описание полей:

• currency_from: string (required) - ISO код валюты клиента или в какой валюте будет происходить расчет
• currency_to: string (required) - ISO код валюты получателя платежа
• amount: number, float (required) - исходная сумма для обмена в валюте currency_from
• subtype: string (optional) - Метод исполнения выплатной транзакции

Разбор ответа:

• Status 200:

  {
      "id": "be9675e3-bd27-4d8b-a10f-4b357803f4c8",
      "finalAmount": 3404.23,
      "direction": 'FIAT_OUT',
      "fullRate": 443.2214,
      "fullRateReverse": 0.01241,
      "fees": 0,
      "fees_percent": 0,
      "expiredAt": "2025-05-13T18:57:27.489Z"
  }
  

  • id: (uuid) - Уникальный ID запроса, используется для следующего шага оплаты;
  • finalAmount: (number, float) - Сумма к получению в локальной валюте (currencyFrom);
  • direction: (string) - Направление обмена, служебное поле, принимает одно из значений: C2F, FIAT_OUT;
  • fullRate: (number, float) - Полный курс обмена для конечного клиента, 4 десятичных знака;
  • fullRateReverse: (number, float) - Обратный курс обмена;
  • fees: (number, float) - Сумма комиссий за обмен в валюте currencyFrom;
  • fees_percent: (number, float) - Процентная ставка комиссии за обмен;
  • expiredAt: (date-time) - Дата и время, до которого можно создать платеж по текущей сессии;

• Status 400: Authentication failed. Access token is invalid.

  {
  "error": "ERROR_ACCESS_TOKEN_INVALID", 
  "message": "Access token is invalid.", 
  "statusCode": 400 
  }
  

  • error: string (required)
  • message: string (required)
  • statusCode: number

• Status 401: Authentication failed. Access token has expired.

  {
  "error": "ERROR_TOKEN_EXPIRED", 
  "message": "Access token has expired.", 
  "statusCode": 401 
  }
  

• Status 400: Currency not supported

  {
  "error": "ERROR_CURRENCY_FROM_INVALID", 
  "message": "Use only valid currency (id or symbol)", 
  "statusCode": 400 
  }
  

  • error: string (required)
  • message: string (required)
  • statusCode: number

• Status 400: Direction not supported

  {
  "error": "ERROR_EXCHANGE_DIRECTION_STOPPED", 
  "message": "Exchange direction isn`t available right now", 
  "statusCode": 400 
  }
  

  • error: string (required)
  • message: string (required)
  • statusCode: number

• Status 500: Project tariff not configured, pls contact with our support.

  {
    "error": "TARIFF_NO_FOUND",
    "message": "Project tariff not configured, pls contact with our support.",
    "statusCode": 500
  }
  

  • error: string (required)
  • message: string (required)
  • statusCode: number