Stablecoin Payment Capture

This guide covers how to capture stablecoin payments after initialization. The capture process confirms the blockchain address and network for the payment.

Overview

Ensure you’ve completed payment initialization before attempting capture.

Endpoint

POST /payment-sessions/{payment_id}

Supported Tokens and Networks

USDC Support Matrix

Network	Status	Confirmation Time
ETH	✅	5-30 minutes
MATIC	✅	1-5 minutes
AVAXC	✅	1-5 minutes

USDT Support Matrix

Network	Status	Confirmation Time
ETH	✅	5-30 minutes
TRX	✅	1-3 minutes

Always verify the network matches the token to avoid lost transactions. For example, send USDC only on ETH, MATIC, or AVAXC networks.

Request Parameters

object

required

Crypto payment details

Show Crypto Address Fields

string

required

Blockchain network code: * ETH (Ethereum) * TRX (Tron) * MATIC (Polygon) * AVAXC (Avalanche C-Chain)

string

required

Stablecoin type: * USDC * USDT

Example Requests

{
  "crypto_address": {
    "chain": "TRX",
    "currency": "USDT"
  }
}

{
  "crypto_address": {
    "chain": "MATIC",
    "currency": "USDC"
  }
}

Response Format

object

Show Response Fields

string

Payment status: “captured”, “failed”

string

Additional status information

object

Show Payment Details

string

Unique payment identifier

object

Show Payment Method Details

string

Generated blockchain address for payment

string

Selected blockchain network

string

Selected stablecoin

string

Will be “crypto_address”

string

Current payment status

Example Response

{
  "data": {
    "status": "captured",
    "message": "Payment address generated successfully",
    "payment": {
      "id": "pay_123abc456def",
      "currency": "USDT",
      "amount": 100000,
      "description": "Crypto payment",
      "payment_method": {
        "address": "TAd3A1MPNb3xhWrCpmi9x7UdqtwigWcdea",
        "chain": "TRX",
        "currency": "USDT",
        "id": "f1ce6d0f-b30b-4c53-810d-77584f2a36fb",
        "type": "crypto_address"
      },
      "status": "captured",
      "date": "2024-03-15T12:00:00Z",
      "mode": "live",
      "customer": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "john.doe@example.com",
        "billing_address": {
          "line1": "123 Main St",
          "line2": "Apt 4B",
          "city": "New York",
          "state": "NY",
          "zip_code": "10001",
          "country": "US"
        }
      },
      "reference": "crypto_pay_123"
    }
  }
}

Transaction Flow

Generate Address

Capture request generates a unique blockchain address

Monitor Transaction

Listen for webhook events: * crypto.payment.pending - Transaction detected * crypto.payment.confirmed - Required confirmations reached * crypto.payment.completed - Funds credited

Verify Amount

Ensure received amount matches expected payment

Best Practices

Network Selection

Use TRX network for lowest fees * Consider ETH during low gas periods * Use MATIC/AVAXC for faster confirmations

Error Handling

Validate chain/token compatibility * Handle network congestion gracefully
Monitor transaction timeouts

User Experience

Display QR code for address * Show clear network requirements * Provide transaction instructions

Need Help?

Check our Error Handling Guide * Contact support@juicyway.com * Join our Discord community

Home

Customers

Payments

Payment Transactions

Transfers

Exchange

Wallet As A Service

Stablecoins payment

Stablecoin Payment Capture

Overview

Endpoint

Supported Tokens and Networks

Request Parameters

Example Requests

Response Format

Example Response

Transaction Flow

Best Practices

Need Help?

​Stablecoin Payment Capture

​Overview

​Endpoint

​Supported Tokens and Networks

​Request Parameters

​Example Requests

​Response Format

​Example Response

​Transaction Flow

​Best Practices

Need Help?

Stablecoin Payment Capture

Overview

Endpoint

Supported Tokens and Networks

Request Parameters

Example Requests

Response Format

Example Response

Transaction Flow

Best Practices