Skip to content
NearPayments

GET /payment/{track_id}

Returns the current status, configuration, and transaction history of a payment. Requires authentication.

Request

Section titled “Request”
GET /payment/{track_id}

Example

Section titled “Example”
Terminal window
curl https://api.nearpayments.io/oxapay/v1/payment/abc123 \
  -H "merchant_api_key: YOUR_API_KEY"

Payment Statuses

Section titled “Payment Statuses”

The adapter maps OxaPay statuses to the NearPayments canonical status set:

OxaPay StatusNearPayments Status
waitingWaiting
confirmingConfirming
confirmedConfirmed
sendingPaying
finishedPaid
failedFailed
refundedRefunded
expiredExpired

Response

Section titled “Response”
{
  "data": {
    "track_id": "abc123",
    "type": "invoice",
    "amount": 50,
    "currency": "USD",
    "status": "Paid",
    "mixed_payment": false,
    "callback_url": "https://example.com/webhook",
    "description": null,
    "email": null,
    "fee_paid_by_payer": 0,
    "lifetime": 60,
    "order_id": "inv-100",
    "under_paid_coverage": 0,
    "return_url": "https://example.com/thanks",
    "thanks_message": null,
    "expired_at": 1700000000,
    "date": 1699996400,
    "txs": [
      {
        "tx_hash": "a1b2c3...",
        "amount": 0.00083,
        "currency": "BTC",
        "network": "BTC",
        "address": "bc1q...",
        "status": "finished",
        "confirmations": 3,
        "auto_convert": false,
        "auto_withdrawal": false,
        "date": 1699997000
      }
    ]
  },
  "message": "Operation completed successfully!",
  "error": {},
  "status": 200,
  "version": "1.0.0"
}