GET/payment/status

Check payment status by payment_id or PayCrypt-generated order_id. Returns the full payment object including the events timeline.

data_objectQuery Parameters

ParameterTypeDescription
payment_idstring (UUID)Payment ID returned from /payment/create. Either this or order_id is required.
order_idstringSystem-generated order reference returned from /payment/create. Either this or payment_id is required.
Request
cURL
curl "https://api.paycrypt.io/payment/status?payment_id=9515b51e-0279-4294-805d-91f7762914c3" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
jsonResponse — 200 OK
{
  "payment_id": "9515b51e-0279-4294-805d-91f7762914c3",
  "order_id": "123",
  "status": "confirmed",
  "amount": 50,
  "amount_received": 50.02,
  "amount_received_usd": 50.02,
  "coin": "USDT",
  "network": "ethereum",
  "currency": "USD",
  "deposit_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD68",
  "expires_at": "2026-02-20T10:10:46.000Z",
  "tx_hash": "0x8a2f7b3c9d1e5f6a4b8c2d0e1f3a5b7c9d2e4f6a8b0c2d4e6f8a0b2c4d6e8f",
  "block_number": "19234567",
  "confirmations": 12,
  "confirmed_at": "2026-02-20T10:02:15.844Z",
  "created_at": "2026-02-20T09:55:46.541Z",
  "updated_at": "2026-02-20T10:02:15.844Z",
  "customer_email": "customer@example.com",
  "customer_wallet": null,
  "metadata": { "plan": "pro", "user_id": "u-789" },
  "events": [
    {
      "event_type": "payment.created",
      "description": "Payment created.",
      "occurred_at": "2026-02-20T09:55:46.541Z"
    },
    {
      "event_type": "payment.confirmed",
      "description": "Payment confirmed (deposit received).",
      "occurred_at": "2026-02-20T10:02:15.844Z"
    }
  ]
}

Response Fields

FieldDescription
statusCurrent status: pending, confirmed, underpaid, overpaid, expired, failed
amount_receivedActual crypto amount received on the deposit address
amount_received_usdUSD value of the received amount
tx_hashOn-chain transaction hash (null if not yet received)
block_numberBlock number of the confirming transaction
confirmationsNumber of block confirmations
eventsArray of lifecycle events with timestamps