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",
"paymentMethod": "ACH",
"accountId": null,
"accountName": null,
"sender": null
},
"destination": {
"asset": "USDC_ETHEREUM",
"amount": null,
"fiatCurrency": null,
"imad": null,
"reference": null,
"omad": null,
"traceNumber": null,
"externalAddress": null,
"accountId": "cmbhs3xxa000nynt7lqwbyjsw",
"accountName": "Main Account",
"paymentInstructionId": null
},
"instructions": null,
"createdAt": "2025-06-16T12:16:32.706Z",
"txHash": [],
"feeAmount": "0",
"failureReason": null,
"counterPartyIdentityId": "cmbhs3xxa000nynt7abc12345",
"virtualAccountId": 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",
"paymentMethod": "ACH",
"accountId": null,
"accountName": null,
"sender": null
},
"destination": {
"asset": "USDC_ETHEREUM",
"amount": null,
"fiatCurrency": null,
"imad": null,
"reference": null,
"omad": null,
"traceNumber": null,
"externalAddress": null,
"accountId": "cmbhs3xxa000nynt7lqwbyjsw",
"accountName": "Main Account",
"paymentInstructionId": null
},
"instructions": null,
"createdAt": "2025-06-16T12:16:32.706Z",
"txHash": [],
"feeAmount": "0",
"failureReason": null,
"counterPartyIdentityId": "cmbhs3xxa000nynt7abc12345",
"virtualAccountId": null
},
"timestamp": 1750076193367
}
Orchestrating
{
"type": "Transaction_Updated",
"organizationId": "clxt0xrqp0000gokerkq2mpdl",
"data": {
"id": "cmbz26gn6000eyn24nq2hgutw",
"type": "Deposit",
"status": "Orchestrating",
"source": {
"asset": null,
"amount": "1000",
"fiatCurrency": "USD",
"paymentMethod": "ACH",
"accountId": null,
"accountName": null,
"sender": null
},
"destination": {
"asset": "USDC_ETHEREUM",
"amount": null,
"fiatCurrency": null,
"imad": null,
"reference": null,
"omad": null,
"traceNumber": null,
"externalAddress": null,
"accountId": "cmbhs3xxa000nynt7lqwbyjsw",
"accountName": "Main Account",
"paymentInstructionId": null
},
"instructions": null,
"createdAt": "2025-06-16T12:16:32.706Z",
"txHash": [],
"feeAmount": "0",
"failureReason": null,
"counterPartyIdentityId": "cmbhs3xxa000nynt7abc12345",
"virtualAccountId": null
},
"timestamp": 1750076193658
}
Pending
{
"type": "Transaction_Updated",
"organizationId": "clxt0xrqp0000gokerkq2mpdl",
"data": {
"id": "cmbz26gn6000eyn24nq2hgutw",
"type": "Deposit",
"status": "Pending",
"source": {
"asset": null,
"amount": "1000",
"fiatCurrency": "USD",
"paymentMethod": "ACH",
"accountId": null,
"accountName": null,
"sender": null
},
"destination": {
"asset": "USDC_ETHEREUM",
"amount": "1000",
"fiatCurrency": null,
"imad": null,
"reference": null,
"omad": null,
"traceNumber": null,
"externalAddress": null,
"accountId": "cmbhs3xxa000nynt7lqwbyjsw",
"accountName": "Main Account",
"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,
"counterPartyIdentityId": "cmbhs3xxa000nynt7abc12345",
"virtualAccountId": null
},
"timestamp": 1750076194846
}
Completed
{
"type": "Transaction_Updated",
"organizationId": "clxt0xrqp0000gokerkq2mpdl",
"data": {
"id": "cmbz26gn6000eyn24nq2hgutw",
"type": "Deposit",
"status": "Completed",
"source": {
"asset": null,
"amount": "1000",
"fiatCurrency": "USD",
"paymentMethod": "ACH",
"accountId": null,
"accountName": null,
"sender": null
},
"destination": {
"asset": "USDC_ETHEREUM",
"amount": "1000",
"fiatCurrency": null,
"imad": null,
"reference": null,
"omad": null,
"traceNumber": null,
"externalAddress": null,
"accountId": "cmbhs3xxa000nynt7lqwbyjsw",
"accountName": "Main Account",
"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": [
"0xabc123..."
],
"feeAmount": "0",
"failureReason": null,
"counterPartyIdentityId": "cmbhs3xxa000nynt7abc12345",
"virtualAccountId": 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",
"paymentMethod": "ACH",
"accountId": null,
"accountName": null,
"sender": null
},
"destination": {
"asset": "USDC_SOLANA",
"amount": null,
"fiatCurrency": null,
"imad": null,
"reference": null,
"omad": null,
"traceNumber": null,
"externalAddress": null,
"accountId": "cmbz2dgni000tyn241ip38gwj",
"accountName": "Main Account",
"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",
"counterPartyIdentityId": "cmbhs3xxa000nynt7abc12345",
"virtualAccountId": null
},
"timestamp": 1750082398433
}
If you have any questions, please don’t hesitate to reach out to us via email or slack.