Check a Payment Intent

POST /api/v1/payment_intents/:id/check

curl https://api-prod.paybytoken.io/api/v1/payment_intents/pay_t24b28nbodnk4icGMyE7/check \
  -X POST \
  -H "Authorization: Bearer $PAYBYTOKEN_SECRET_KEY"

This rate-limited endpoint checks the one-time address immediately. Background payment monitoring continues independently, so normal integrations do not need to poll this endpoint aggressively.

Response

The response is a compact observation, not the full PaymentIntent object.

{
  "status": "requires_confirmation",
  "currency": "USDC",
  "chain": "base",
  "tx_hash": "0xabcd...",
  "payer_address": "0x1234...",
  "balance_detected_block": 32600123,
  "confirmations": 1,
  "required_confirmations": 2
}

Before a transfer is detected, status can be the transient value pending. Once enough confirmations are present, the response is succeeded; fulfillment should still be driven by the verified payment_intent.succeeded webhook.