Skip to main content
GET
/
v1
/
payments
/
{id}
curl -X GET "https://olp-api.nipuntheekshana.com/v1/payments/pay_abc123def456" \
  -H "Authorization: Bearer <your_jwt_token>"

{
  "id": "pay_abc123def456",
  "status": "paid",
  "amount": 25.00,
  "currency": "USD",
  "cryptoAmount": "25.032500",
  "cryptoAddress": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
  "qrCodeUrl": "https://olp-api.nipuntheekshana.com/qr/pay_abc123def456.png",
  "checkoutUrl": "https://olp-checkout.nipuntheekshana.com/pay/pay_abc123def456",
  "description": "Order #1234 - Premium Plan",
  "customerEmail": "customer@example.com",
  "metadata": {
    "orderId": "order_1234",
    "plan": "premium"
  },
  "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "paidAt": "2026-03-26T14:55:12Z",
  "expiresAt": "2026-03-26T15:30:00Z",
  "createdAt": "2026-03-26T14:30:00Z"
}

​
Authentication

This endpoint supports two authentication methods:
  • Bearer token via the Authorization header
  • HMAC signature via X-API-Key and X-Signature headers
Authorization: Bearer <your_jwt_token>
or 
X-API-Key: <your_api_key>
X-Signature: <hmac_sha256_signature>

​
Path Parameters

​
id
string
required
The unique identifier of the payment (e.g., pay_abc123def456).

​
Response

​
id
string
Unique identifier for the payment.
​
status
string
Current payment status: initiated, pending, confirming, paid, failed, or expired.
​
amount
number
The fiat amount of the payment.
​
currency
string
The fiat currency (USD or LKR).
​
cryptoAmount
string
The equivalent USDT amount.
​
cryptoAddress
string
The blockchain wallet address for the payment.
​
qrCodeUrl
string
URL to the QR code image.
​
checkoutUrl
string
The hosted checkout page URL.
​
description
string
The payment description.
​
customerEmail
string
The customer’s email address, if provided.
​
metadata
object
Custom key-value metadata attached to the payment.
​
txHash
string
The on-chain transaction hash, available once the payment is detected.
​
paidAt
string
ISO 8601 timestamp of when the payment was confirmed, if applicable.
​
expiresAt
string
ISO 8601 timestamp indicating when the payment expires.
​
createdAt
string
ISO 8601 timestamp of when the payment was created.
curl -X GET "https://olp-api.nipuntheekshana.com/v1/payments/pay_abc123def456" \
  -H "Authorization: Bearer <your_jwt_token>"

{
  "id": "pay_abc123def456",
  "status": "paid",
  "amount": 25.00,
  "currency": "USD",
  "cryptoAmount": "25.032500",
  "cryptoAddress": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
  "qrCodeUrl": "https://olp-api.nipuntheekshana.com/qr/pay_abc123def456.png",
  "checkoutUrl": "https://olp-checkout.nipuntheekshana.com/pay/pay_abc123def456",
  "description": "Order #1234 - Premium Plan",
  "customerEmail": "customer@example.com",
  "metadata": {
    "orderId": "order_1234",
    "plan": "premium"
  },
  "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "paidAt": "2026-03-26T14:55:12Z",
  "expiresAt": "2026-03-26T15:30:00Z",
  "createdAt": "2026-03-26T14:30:00Z"
}