Docs
  • What We Do
  • Supported Countries, Payment Methods, and Cryptocurrencies
  • Getting Started
  • Integration Guides
    • API
      • Required Headers
      • Create a User
      • Assign a Deposit Address
      • KYC
      • Link and Verify a Bank Account
        • Re-link Bank Account
        • Update Bank Account
        • Delete Bank Account
      • Transaction Limits
      • Buy Crypto (ACH)
      • Transaction Monitoring
      • Transaction History
    • React Native
      • Installation
      • Session Token and Wallet Signing
      • Preset Order Details
      • Example
      • Reference
      • Release History
      • User experience
        • Sign up
        • Sign in
        • Buy crypto
        • Settings & activity
    • React JS (Beta)
      • Installation
      • Session Token and Wallet Signing
      • Preset Orders
      • Callbacks
      • Theming
      • Example
      • Reference
      • Release History
  • API Reference
    • Endpoints
      • Auth
        • Crypto Wallet
        • Email OTP
        • SMS OTP
      • Activity
      • Bank
      • Client
      • Config
      • Crypto
      • Users
      • Wallets
      • Webhook Registrations
    • Custom Headers
    • Error Codes
    • Types Glossary
    • Postman
    • Open API Specification
    • Webhooks
  • Design Reference
    • UI/UX Starter kit
    • UI Requirements
  • Guides
    • Sandbox Testing
    • User Authentication
    • Link a new Signing Wallet to an Existing User
    • Plaid Bank Linking
      • Plaid OAuth Support
    • Client Dashboard (Alpha)
  • User Support Reference
    • User Account Flags
      • KYC Review
      • Transaction Processing
      • NSFs and Returned Payments
      • Fraud
    • Transactional Emails
Powered by GitBook
On this page

Was this helpful?

  1. Integration Guides
  2. API

Transaction Monitoring

Once you have successfully submitted a crypto purchase transaction, you should monitor the transaction status.

PreviousBuy Crypto (ACH)NextTransaction History

Last updated 2 years ago

Was this helpful?

You will monitor the transaction status using the activity ID returned by the /ach endpoint.

Crypto Status

The crypto status will always start as PENDING. Then will go to COMPLETE or FAILED.

The crypto status will be marked as COMPLETE when the transaction has been successfully executed onchain. This can take 20 seconds (Polygon) to minutes (Ethereum) depending on the chain and network congestion.

We recommend that you exit the user from the purchase flow as soon as the transaction is accepted and crypto status = PENDING.

If you are going to poll for the crypto status update we recommend every 2 seconds, for 10 times, and then polling every 10 seconds thereafter until the status changes

If COMPLETE

You can retrieve the transactionHash.

If FAILED

You should call GET /user and review the flags. There will be a Transaction Processing flag on the account.

Fiat Status

You do not need to monitor the fiat status of an activity item. If the fiat status fails you will be able to handle the error by looking at the user account flags.

We recommend polling the crypto status or subscribing to activity item events via , so that you can present the transaction hash to the user once the transaction is marked COMPLETE.

webhooks