Transfer Status - Carbn Connect

Understanding transfer statuses is crucial for providing users with accurate information about their payments and handling edge cases appropriately. This guide covers all possible transfer states and how to monitor them effectively.

Transfer Lifecycle

All transfers in Carbn Connect follow a predictable lifecycle with specific states that indicate the current stage of processing:

Initiation

Transfer is created and awaiting funds or processing

Processing

Funds are being moved through the payment system

Completion

Transfer reaches final state (success, failure, or requires action)

Transfer States

The transfer status indicates the current state of a transfer. Here are all possible states:

awaiting_funds

Description: Carbn is waiting to receive funds from the user before processing the transfer.Applies to:

SEPA Payments
Wire transfers
ACH pushes
Virtual account transfers

Next Steps: Wait for user to send funds or complete payment flow.

{
  "transaction_id": "d5c48677-b85d-4de5-a685-196d0e6596f7",
  "status": "awaiting_funds",
  "created_at": "2024-01-01T10:00:00Z",
  "source_currency": "eur",
  "amount": 100
}

funds_received

Description: Carbn has received the funds and is preparing to move them on the user’s behalf.Duration: Usually seconds to a few minutesWhat’s happening: Internal processing, validation, and preparation for onward transfer.

{
  "transaction_id": "d5c48677-b85d-4de5-a685-196d0e6596f7",
  "status": "funds_received",
  "updated_at": "2024-01-01T10:05:00Z",
  "source_currency": "eur",
  "amount": 100
}

in_review

payment_submitted

Description: Carbn has initiated the payment and is awaiting confirmation.Duration varies by payment rail:

Crypto: Minutes
Wires: Hours
ACH: Days

{
  "transaction_id": "d5c48677-b85d-4de5-a685-196d0e6596f7",
  "status": "payment_submitted",
  "updated_at": "2024-01-01T10:06:00Z",
  "payment_rail": "crypto",
  "estimated_completion": "2024-01-01T10:15:00Z"
}

payment_processed

Description: The transfer is complete and funds have been successfully delivered to the destination.Final State: This is a successful completion state.

{
  "transaction_id": "d5c48677-b85d-4de5-a685-196d0e6596f7",
  "status": "payment_processed",
  "completed_at": "2024-01-01T10:12:00Z",
  "final_amount": 95.50,
  "destination_confirmed": true
}

Exception States

undeliverable

returned

refunded

canceled

error

Monitoring Transfer Status

Check Individual Transfer Status

Monitor specific transfers using the status endpoints:

curl --location --request GET 'https://api.carbnconnect.com/payment/api/v1/onramp-audit/status/{transaction_id}' \
--header 'x-api-key: <your-api-key>'

Bulk Transfer Monitoring

Get status for multiple transfers by user:

curl --location --request GET 'https://api.carbnconnect.com/payment/api/v1/onramp-audit/{wallet_id}' \
--header 'x-api-key: <your-api-key>'

State Progression Rules

Important: Transfers always progress forward through states and never go backwards:awaiting_funds → funds_received → payment_submitted → payment_processed