Skip to content

Проверка статуса транзакции

Запрос:

curl -X GET https://api.creon.ae/v2/{id} \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "Content-Type: application/json" \

id: uuid (required) — ID из ответа на запрос /fx/calculatenew; либо ID, переданный нам на этапе финализации платежа в параметре invoiceId; либо ID из ответа на на запрос /deals/payout

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

  • Status 200:

    {
      "id": "2d4d3684-91bb-4395-8b76-f2f4b30dd0f",
      "invoiceId": "00000203023",
      "clientId": "1232023032-23023023",
      "amount": 120,
      "amountToPay": 3223.23,
      "currency": "TRY",
      "currencyToPay": "RUB",
      "fee": 0,
      "feePercent": 0,
      "fullRate": 323,
      "baseRate": 300,
      "status": "completed",
      "reason": "BAD_RECIPIENT_BANK_ID",
      "createdAt": "2025-05-13T18:57:27.489Z",
      "completedAt": "2025-05-13T19:08:27.000Z"
    }
    

    • id (string): Уникальный идентификатор запроса на оплату;
    • invoiceId (string): Внутренний уникальный номер инвойса мерчанта;
    • clientId (string): Идентификатор клиента в системе мерчанта, помогает связывать платёж с пользователем;
    • amount (required) (float): Сумма платежа в локальной валюте, которая прийдет получателю
    • currency (required) (string): ISO-код валюты получателя
    • currencyToPay (required) (string): ISO-код валюты отправителя
    • amountToPay (required)(float): Сумма к списанию в валюте отправителя;
    • fee (required) (float): Комиссия платёжного провайдера в валюте отправителя;
    • feePercent (required) (float): Процент комиссии по тарифу;
    • fullRate (required) (float): Обменный курс, рассчитанный как amount / amountToPay;
    • baseRate (required) (float): Базовый обменный курс для пары валют;
    • status (required) (string): Текущий статус платежа — может принимать значения paid, completed canceled, expired, new, queued
    • reason (optional)(string): причина отклонения транзакции
    • createdAt (date-time): Временная метка (ISO 8601) создания запроса на оплату;
    • completedAt (date-time): Временная метка (ISO 8601) завершения платежа (успешного или отмены);
  • Status 400: Invalid request, typically due to a missing or malformed parameter.

{
"error": "ERROR_ACCESS_TOKEN_INVALID", 
"message": "Access token is invalid.", 
"statusCode": 400 
}
- `error`: string (required)
- `message`: string (required)
- `statusCode`: number
  • Status 401: Authentication failed. This may happen due to the following reasons:

    • Authentication is required but not provided.
    • The access token has expired.
{
"error": "ERROR_TOKEN_EXPIRED", 
"message": "Access token has expired.", 
"statusCode": 401 
}
- `error`: string (required)
- `message`: string (required)
- `statusCode`: number
  • Status 500: Transaction with specified ID not found.
{
"error": "TRANSACTION_NOT_FOUND", 
"message": "Transaction with specified ID not found.", 
"statusCode": 500 
}
- `error`: string (required)
- `message`: string (required)
- `statusCode`: number