Skip to main content
GET
List crypto payment sessions
Retrieves a list of generated crypto payment sessions. Supports filtering by status, reference, customer ID, and pagination limits.

Payment Session Statuses

NexaPay returns statuses such as:
  • INITIATED
  • ADDRESS_PENDING
  • AWAITING_DEPOSIT
  • PENDING_CONFIRMATION
  • SWEEP_PENDING
  • SETTLED (means the session deposit has been settled into the merchant’s USDT balance)
  • UNDERPAID
  • OVERPAID
  • EXPIRED
  • MANUAL_REVIEW
  • FAILED

Authorizations

x-api-key
string
header
required

Merchant API Key (e.g., nexa-prod-... or nexa-test-...)

Headers

x-business-env
enum<string>
default:prod

Target environment selector (live production vs. simulated sandbox).

Available options:
prod,
test

Query Parameters

status
string
merchantReference
string
merchantCustomerId
string
limit
integer
default:20
businessId
string
required

The unique ID of the business profile (required for API key authentication).

Response

200

List of payment sessions.