CryptoCheckout documentation

POST /pool-deposit-status

Use webhooks as your primary signal. Poll only to reconcile stragglers or after your endpoint was down.

Request

string

required

Deposit intent ID, or the payment ID from your quote.

Response

string

Intent ID.

string

Current state. See below.

string

Quoted amount, base units.

string

Actually received. Compare against expected for under- and overpayment.

string

Token.

number

Chain.

string

Inbound transaction, once seen.

number

Confirmations so far.

string

Quote expiry.

Statuses

Status	Meaning	Safe to ship
`waiting`	Address issued, nothing received	No
`confirming`	Seen, awaiting confirmations	No
`paid`	Correct amount confirmed	No — wait for `swept`
`swept`	Settled into your pool	Yes
`underpaid`	Less than expected	Your call
`overpaid`	More than expected	Yes, refund difference
`wrong_token`	Token not enabled	No
`expired`	Lapsed, nothing received	No
`expired_paid_late`	Paid after expiry	Usually yes
`held_sanctioned`	Compliance hold	No

On the deposit rail, swept is the fulfilment signal — the money is in your pool. paid means the inbound transfer confirmed but our sweep hasn’t landed yet. The payment_confirmed webhook already accounts for this, which is why webhooks are simpler than polling.

curl -X POST $CC_API_BASE/pool-deposit-status \
  -H "apikey: $CC_PUBLISHABLE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "dep_4c8e…" }'

async function checkPayment(id) {
  const res = await fetch(
    `${process.env.CC_API_BASE}/pool-deposit-status`,
    {
      method: "POST",
      headers: {
        apikey: process.env.CC_PUBLISHABLE_KEY,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ id }),
    }
  );
  return res.json();
}

{
  "id": "dep_4c8e…",
  "status": "swept",
  "expectedAmount": "49000000",
  "confirmedAmount": "49000000",
  "token": "EURC",
  "chainId": 8453,
  "txHash": "0x3d9a…",
  "confirmations": 12,
  "expiresAt": "2026-08-09T15:02:11.204Z"
}

Polling sensibly

// Backstop only — webhooks are the primary path.
async function reconcile(order) {
  const p = await checkPayment(order.depositId);

  if (p.status === "swept" && !order.fulfilled) {
    await fulfil(order);            // webhook was missed
  }

  if (p.status === "underpaid") {
    await flagForReview(order, p);
  }
}

Do

Poll pending orders on a schedule — every few minutes, backing off over time. Reconcile daily against the dashboard ledger.

Don't

Poll in a tight loop from the browser, or poll every order forever. You’ll hit rate limits and gain nothing.

Exceeding the rate limit returns 429 with Retry-After. Respect it.

Using the API

Endpoints

Check payment status

Request

Response

Statuses

Polling sensibly

Do

Don't

​Request

​Response

​Statuses

​Polling sensibly

Do

Don't

Request

Response

Statuses

Polling sensibly