Skip to main content
If you’re just getting started, please check out our quick start guide.

​
Transaction creation

When a deposit request is submitted to the borderless, a webhook notification will be sent to the configured webhook URL. This notification will contain the relevant transaction details for further processing or integration with your system. Webhook payload is below: 
{
    "type": "Transaction_Created",
    "organizationId": "clxt0xrqp0000gokerkq2mpdl",
    "data": {
        "id": "cmbz26gn6000eyn24nq2hgutw",
        "type": "Deposit",
        "status": "Submitted",
        "source": {
            "asset": null,
            "amount": "1000",
            "fiatCurrency": "USD",
            "accountId": null,
            "counterPartyIdentityId": null
        },
        "destination": {
            "asset": "USDC_ETHEREUM",
            "fiatCurrency": null,
            "imad": null,
            "omad": null,
            "traceNumber": null,
            "externalAddress": null,
            "accountId": "cmbhs3xxa000nynt7lqwbyjsw",
            "paymentInstructionId": null
        },
        "instructions": null,
        "createdAt": "2025-06-16T12:16:32.706Z",
        "txHash": [],
        "feeAmount": "0",
        "failureReason": null
    },
    "timestamp": 1750076192717
}

​
Transaction state changes

Subsequent transaction processing updates and state changes will be communicated via webhook notifications to the configured webhook URL. Webhook payload remains as previous, please note its status change:

​
Verifying

{
    "type": "Transaction_Updated",
    "organizationId": "clxt0xrqp0000gokerkq2mpdl",
    "data": {
        "id": "cmbz26gn6000eyn24nq2hgutw",
        "type": "Deposit",
        "status": "Verifying",
        "source": {
            "asset": null,
            "amount": "1000",
            "fiatCurrency": "USD",
            "accountId": null,
            "counterPartyIdentityId": null
        },
        "destination": {
            "asset": "USDC_ETHEREUM",
            "fiatCurrency": null,
            "imad": null,
            "omad": null,
            "traceNumber": null,
            "externalAddress": null,
            "accountId": "cmbhs3xxa000nynt7lqwbyjsw",
            "paymentInstructionId": null
        },
        "instructions": null,
        "createdAt": "2025-06-16T12:16:32.706Z",
        "txHash": [],
        "feeAmount": "0",
        "failureReason": null
    },
    "timestamp": 1750076193367
}

​
Orchestrating

{
    "type": "Transaction_Updated",
    "organizationId": "clxt0xrqp0000gokerkq2mpdl",
    "data": {
        "id": "cmbz26gn6000eyn24nq2hgutw",
        "type": "Deposit",
        "status": "Orchestrating",
        "source": {
            "asset": null,
            "amount": "1000",
            "fiatCurrency": "USD",
            "accountId": null,
            "counterPartyIdentityId": null
        },
        "destination": {
            "asset": "USDC_ETHEREUM",
            "fiatCurrency": null,
            "imad": null,
            "omad": null,
            "traceNumber": null,
            "externalAddress": null,
            "accountId": "cmbhs3xxa000nynt7lqwbyjsw",
            "paymentInstructionId": null
        },
        "instructions": null,
        "createdAt": "2025-06-16T12:16:32.706Z",
        "txHash": [],
        "feeAmount": "0",
        "failureReason": null
    },
    "timestamp": 1750076193658
}

​
Pending

{
    "type": "Transaction_Updated",
    "organizationId": "clxt0xrqp0000gokerkq2mpdl",
    "data": {
        "id": "cmbz26gn6000eyn24nq2hgutw",
        "type": "Deposit",
        "status": "Pending",
        "source": {
            "asset": null,
            "amount": "1000",
            "fiatCurrency": "USD",
            "accountId": null,
            "counterPartyIdentityId": null
        },
        "destination": {
            "asset": "USDC_ETHEREUM",
            "amount": "1000",
            "fiatCurrency": null,
            "imad": null,
            "omad": null,
            "traceNumber": null,
            "externalAddress": null,
            "accountId": "cmbhs3xxa000nynt7lqwbyjsw",
            "paymentInstructionId": null
        },
        "instructions": {
            "amount": "1000.0",
            "currency": "usd",
            "bank_name": "Bank of Nowhere",
            "bank_address": "1800 North Pole St., Orlando, FL 32801",
            "payment_rail": "wire",
            "deposit_message": "BRGZHDZ83UK2884Y6G3U",
            "bank_account_number": "11223344556677",
            "bank_routing_number": "123456789",
            "bank_beneficiary_name": "Bridge Ventures Inc",
            "bank_beneficiary_address": "1234 Elm St, Springfield, IL 12345"
        },
        "createdAt": "2025-06-16T12:16:32.706Z",
        "txHash": [],
        "feeAmount": "0",
        "failureReason": null
    },
    "timestamp": 1750076194846
}

​
Completed

{
    "type": "Transaction_Updated",
    "organizationId": "clxt0xrqp0000gokerkq2mpdl",
    "data": {
        "id": "cmbz26gn6000eyn24nq2hgutw",
        "type": "Deposit",
        "status": "Completed",
        "source": {
            "asset": null,
            "amount": "1000",
            "fiatCurrency": "USD",
            "accountId": null,
            "counterPartyIdentityId": null
        },
        "destination": {
            "asset": "USDC_ETHEREUM",
            "amount": "1000",
            "fiatCurrency": null,
            "imad": null,
            "omad": null,
            "traceNumber": null,
            "externalAddress": null,
            "accountId": "cmbhs3xxa000nynt7lqwbyjsw",
            "paymentInstructionId": null
        },
        "instructions": {
            "amount": "1000.0",
            "currency": "usd",
            "bank_name": "Bank of Nowhere",
            "bank_address": "1800 North Pole St., Orlando, FL 32801",
            "payment_rail": "wire",
            "deposit_message": "BRGZHDZ83UK2884Y6G3U",
            "bank_account_number": "11223344556677",
            "bank_routing_number": "123456789",
            "bank_beneficiary_name": "Bridge Ventures Inc",
            "bank_beneficiary_address": "1234 Elm St, Springfield, IL 12345"
        },
        "createdAt": "2025-06-16T12:16:32.706Z",
        "txHash": [
            null
        ],
        "feeAmount": "0",
        "failureReason": null
    },
    "timestamp": 1750076495740
}

​
Transaction failure

In the case of a transaction failure, a webhook notification is sent to the configured webhook URL. This notification contains detailed information about the transaction and the reason for its failure. 
{
    "type": "Transaction_Updated",
    "organizationId": "clxt0xrqp0000gokerkq2mpdl",
    "data": {
        "id": "cmbz5vfzr0001ynfeqby1yypt",
        "type": "Deposit",
        "status": "Failed",
        "source": {
            "asset": null,
            "amount": "1000",
            "fiatCurrency": "USD",
            "accountId": null,
            "counterPartyIdentityId": null
        },
        "destination": {
            "asset": "USDC_SOLANA",
            "fiatCurrency": null,
            "imad": null,
            "omad": null,
            "traceNumber": null,
            "externalAddress": null,
            "accountId": "cmbz2dgni000tyn241ip38gwj",
            "paymentInstructionId": null
        },
        "instructions": null,
        "createdAt": "2025-06-16T13:59:57.111Z",
        "txHash": [],
        "feeAmount": "0",
        "failureReason": "Couldn't find asset USDC_SOLANA in account: cmbz2dgni000tyn241ip38gwj, add this asset to account before using it"
    },
    "timestamp": 1750082398433
}
If you have any questions, please don’t hesitate to reach out to us via email or slack.