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"
}
Payments
Get Payment
Retrieve the details and current status of a specific payment
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
Authorizationheader - HMAC signature via
X-API-KeyandX-Signatureheaders
Authorization: Bearer <your_jwt_token>
X-API-Key: <your_api_key>
X-Signature: <hmac_sha256_signature>
Path Parameters
string
required
The unique identifier of the payment (e.g.,
pay_abc123def456).Response
string
Unique identifier for the payment.
string
Current payment status:
initiated, pending, confirming, paid, failed, or expired.number
The fiat amount of the payment.
string
The fiat currency (
USD or LKR).string
The equivalent USDT amount.
string
The blockchain wallet address for the payment.
string
URL to the QR code image.
string
The hosted checkout page URL.
string
The payment description.
string
The customer’s email address, if provided.
object
Custom key-value metadata attached to the payment.
string
The on-chain transaction hash, available once the payment is detected.
string
ISO 8601 timestamp of when the payment was confirmed, if applicable.
string
ISO 8601 timestamp indicating when the payment expires.
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"
}