Payment status

Overview

Use this endpoint to poll the current invoice payment status for a session (for example, to update a checkout UI while the user is paying).

Requires:

Endpoint:

Playground (interactive reference):

Example:

BASE_URL=${PEPAY_API_URL}

curl "$BASE_URL/api/v1/payments/payment-status" \
  -H "x-session-token: pst_..." \
  -H "x-signature: sig_..."

{
  "status": "unpaid",
  "paid_at": null
}

If status is underpaid, fetch session details to read the locked network/token:

curl "$BASE_URL/api/v1/payments/session-details" \
  -H "x-session-token: pst_..." \
  -H "x-signature: sig_..."