Currently, Conduit Financial offers webhooks for real-time transaction status updates. We encourage migrating to our Webhook API for better performance and reliability.

However, clients can still programmatically check the status of transactions, counterparties, and balances using our API.

Polling for Status Changes

To track updates efficiently, we recommend implementing a polling mechanism where your system periodically queries the API for the latest transaction status. This approach ensures your application remains up-to-date with minimal delay.

Recommended Polling Strategy:

Use efficient intervals: Poll at reasonable intervals (e.g., every 30 seconds) to balance responsiveness with performance.
Leverage caching: Store previous responses to detect changes efficiently.

Below are examples (with placeholders) showing how to check a transaction’s status, retrieve an account’s balance, and get a counterparty’s status. Replace the example IDs and credentials with your actual values.

Check Transaction Status

curl --request GET \
  --url https://api.conduit.financial/transactions/trxn_2ji0un2T6BaGhHKsmJu93Zf5OQm \
  --header "Accept: application/json" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "X-API-Secret: YOUR_API_SECRET"

{
  "type": "offramp",
  "id": "trxn_2ji0un2T6BaGhHKsmJu93Zf5OQm",
  "quote": "quote_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
  "source": {
    "id": "bank_2kezVryAA3Uw9LJYBiXUV7Pj6gu",
    "asset": "USDT",
    "network": "tron",
    "amount": "115.000000"
  },
  "destination": {
    "id": "bank_2UOcdiXWXbHdLRl3zfU2gG27yRi",
    "asset": "USD",
    "amount": "117.00"
  },
  "documents": [
    {
      "id": "doc_2ofTAESrTs4uQ8N3yGBMhGj59jV"
    }
  ],
  "status": "completed",
  "createdAt": "2024-10-26T02:21:03.742Z",
  "completedAt": "2024-10-26T02:45:03.742Z",
  "reference": "TRX#09123A",
  "purpose": "Other"
}

The key field to look at is "status", which shows whether the transaction is created, in_compliance_review, completed, etc. By polling this endpoint periodically your application can stay updated on the transaction’s status in near real-time.

Retrieve Account Balance

curl --request GET \
  --url https://api.conduit.financial/accounts/acct_2fvietuCNSu8unMNLsEGBrDTVFn \
  --header "Accept: application/json" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "X-API-Secret: YOUR_API_SECRET"

{
  "data": [
    {
      "id": "acct_2fvietuCNSu8unMNLsEGBrDTVFn",
      "balances": {
        "available": [
          {
            "asset": "USDC",
            "network": "ethereum",
            "amount": "90.000000"
          },
          {
            "asset": "USDT",
            "network": "ethereum",
            "amount": "0"
          },
          {
            "asset": "USDT",
            "network": "tron",
            "amount": "150.320000"
          }
        ]
      },
      "createdAt": "2024-10-27T00:00:00.000Z"
    }
  ],
  "links": {
    "first": "/accounts",
    "next": null
  }
}

Here, the "balances" object shows the account’s available balances.

Get Counterparty Status

curl --request GET \
  --url https://api.conduit.financial/counterparties/cp_ABC123 \
  --header "Accept: application/json" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "X-API-Secret: YOUR_API_SECRET"

{
  "id": "cp_ABC123",
  "type": "individual",
  "firstName": "John",
  "middleName": "Snow",
  "lastName": "Smith",
  "birthDate": "2020-03-15",
  "nationality": "US",
  "email": "[email protected]",
  "phone": "+1-555-123-4567",
  "identificationType": "curp",
  "identificationNumber": "123",
  "address": {
    "streetLine1": "21 Jump Street",
    "streetLine2": "Unit 708",
    "city": "Boston",
    "state": "MA",
    "postalCode": "02111",
    "country": "USA"
  },
  "paymentMethods": [
    {
      "id": "1234",
      "type": "bank",
      "rail": [
        "ted",
        "pix"
      ],
      "bankName": "First National Bank",
      "accountType": "checking",
      "accountOwnerName": "Global Tech Solutions",
      "accountNumber": "123456789",
      "routingNumber": "123",
      "swiftCode": "FNBOUS33",
      "branchCode": "1234",
      "bankCode": "123",
      "currency": "USD",
      "address": {
        "streetLine1": "21 Jump Street",
        "streetLine2": "Unit 708",
        "city": "Boston",
        "state": "MA",
        "postalCode": "02111",
        "country": "USA"
      }
    },
    {
      "id": "bank_1234",
      "type": "wallet",
      "rail": "ethereum",
      "walletAddress": "0X0000000",
      "walletLabel": "Gus Personal ETH Wallet"
    },
    {
      "id": "wlt_1234",
      "type": "wallet",
      "rail": "tron",
      "walletAddress": "T0000000",
      "walletLabel": "Gus Personal Tron Wallet"
    }
  ],
  "documents": [
    {
      "documentId": "doc_1234",
      "documentPurpose": "recurring_payment",
      "documentType": "invoice",
      "documentName": "invoice.png",
      "uploadedAt": "2023-10-15T09:30:00Z"
    }
  ],
  "status": "active",
  "createdAt": "2024-01-01T10:00:00Z",
  "updatedAt": "2024-02-15T15:45:00Z"
}

Check the "status" field to see the counterparty’s current verification status.