Payments
Add funds to your Boltly wallet and review payment history. Payments are processed through Razorpay.
POST
/v1/billing/payments/orders Create payment order
Create a payment order to add funds to your wallet. Returns a Razorpay order to complete checkout.
Parameters
amount number required Amount to add to the wallet. Must be greater than 0.
Request
cURL
curl -X POST https://api.boltly.online/v1/billing/payments/orders \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{ "amount": 500 }'Response
JSON
{
"data": {
"order_id": "order_NxK4f2...",
"amount": 500,
"currency": "INR",
"razorpay_key_id": "rzp_live_..."
}
} POST
/v1/billing/payments/verify Verify payment
Verify a completed Razorpay checkout and credit the wallet.
Parameters
razorpay_order_id string required Order ID returned when the payment order was created.
razorpay_payment_id string required Payment ID returned by Razorpay checkout.
razorpay_signature string required Signature returned by Razorpay checkout, used to verify authenticity.
Request
cURL
curl -X POST https://api.boltly.online/v1/billing/payments/verify \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"razorpay_order_id": "order_NxK4f2...",
"razorpay_payment_id": "pay_NxK5g3...",
"razorpay_signature": "9ef4dc..."
}'Response
JSON
{
"data": {
"status": "captured",
"amount": 500,
"currency": "INR",
"new_balance": 1250.50,
"message": "Payment verified and wallet credited"
}
} GET
/v1/billing/payments List payments
Retrieve your organization's payment history, newest first.
Parameters
page integer Page number. Defaults to 1.
limit integer Results per page.
Request
cURL
curl "https://api.boltly.online/v1/billing/payments?page=1&limit=25" \
-H "X-API-Key: $API_KEY"Response
JSON
{
"data": {
"payments": [
{
"id": "5e1c7a9b-...",
"razorpay_order_id": "order_NxK4f2...",
"razorpay_payment_id": "pay_NxK5g3...",
"amount": 500,
"currency": "INR",
"status": "captured",
"created_at": "2026-04-03T12:00:00Z"
}
],
"pagination": { "page": 1, "limit": 25, "total": 8, "total_pages": 1 }
}
}