​
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

NetworkStatusConfirmation Time
ETH✅5-30 minutes
MATIC✅1-5 minutes
AVAXC✅1-5 minutes

USDT Support Matrix

NetworkStatusConfirmation 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

​
crypto_address
object
required

Crypto payment details

​
Example Requests

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

​
Response Format

​
data
object

​
Example Response

{
  "data": {
    "status": "captured",
    "message": "Payment address generated successfully",
    "payment": {
      "id": "pay_123abc456def",
      "currency": "USD",
      "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",
      "metadata": {
        "order_id": "ORD123"
      }
    }
  }
}

​
Transaction Flow

1

Generate Address

Capture request generates a unique blockchain address

2

Monitor Transaction

Listen for webhook events:

  • crypto.payment.pending - Transaction detected
  • crypto.payment.confirmed - Required confirmations reached
  • crypto.payment.completed - Funds credited
3

Verify Amount

Ensure received amount matches expected payment

​
Best Practices

Need Help?