Skip to main content
GET
/
payment
/
api
/
v1
/
fx-audit
/
status
/
{transaction_id}
Get Transfer Transaction Status
curl --request GET \
  --url https://api.carbnconnect.com/payment/api/v1/fx-audit/status/{transaction_id} \
  --header 'x-api-key: <api-key>'
{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "source_currency": "eur",
  "target_currency": "usd",
  "status": "PAYMENT_PROCESSED",
  "sender_user_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "source_amount": 100,
  "destination_amount": 108.5,
  "bank_txn_reference": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "source_info": {
    "sender_name": "John Doe",
    "source_account_details": {
      "account_type": "bank_account",
      "masked_details": "DE89****0000",
      "payment_rail": "sepa"
    }
  },
  "destination_info": {
    "recipient_name": "Jane Doe",
    "bank_details": {
      "bic": "CHASUS33",
      "account_number": "****1234",
      "bank_name": "Example Bank",
      "payment_rail": "swift"
    },
    "account_id": "9ae6fe4g-b798-545g-c1c6-b69ege7c280d"
  },
  "exchange_rate": 1.085,
  "fees": 0.5,
  "funds_received_at": "YYYY-MM-DDTHH:MM:SS.sssZ",
  "conversion_processed_at": "YYYY-MM-DDTHH:MM:SS.sssZ",
  "payment_processed_at": "YYYY-MM-DDTHH:MM:SS.sssZ"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Must be included in the x-api-key header.

Path Parameters

​
transaction_id
string<uuid>
required

The unique identifier of the transfer transaction

Response

Transfer transaction status retrieved successfully

​
id
string<uuid>

The unique identifier of the transaction

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

​
source_currency
string

Source currency (lowercase)

Example:

"eur"

​
target_currency
string

Target currency (lowercase)

Example:

"usd"

​
status
enum<string>

Current status of the transfer transaction

Available options:
PENDING,
FUNDS_RECEIVED,
CONVERSION_PROCESSED,
PAYMENT_SUBMITTED,
PAYMENT_PROCESSED,
FAILED,
CANCELLED
Example:

"PAYMENT_PROCESSED"

​
sender_user_id
string<uuid>

The unique identifier of the user who initiated the transaction

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

​
source_amount
number

Amount in source currency

Example:

100

​
destination_amount
number

Amount in destination currency (after conversion and fees)

Example:

108.5

​
bank_txn_reference
string<uuid>

Bank transaction reference ID

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

​
source_info
object
​
destination_info
object
​
exchange_rate
number

Exchange rate used for currency conversion

Example:

1.085

​
fees
number

Transaction fees applied

Example:

0.5

​
funds_received_at
string<date-time>

Timestamp when source funds were received

Example:

"YYYY-MM-DDTHH:MM:SS.sssZ"

​
conversion_processed_at
string<date-time>

Timestamp when currency conversion was processed

Example:

"YYYY-MM-DDTHH:MM:SS.sssZ"

​
payment_processed_at
string<date-time>

Timestamp when destination payment was processed

Example:

"YYYY-MM-DDTHH:MM:SS.sssZ"