create_payment_link
Create a payment link in NPR for Nepal via Khalti. Buyer pays with Khalti wallet, eBanking, mobile banking, cards. Returns a hosted checkout URL the buyer opens to pay — payment completes automatically, no confirm step. Bring your own credentials via HTTP header (x-khalti-secret-key; free test credentials from admin.khalti.com never move real money). Money always flows buyer→Khalti→merchant; this service never touches funds.
Parameters5
| amount_npr | number | required | Amount in NPR (decimals allowed), e.g. 100. Minimum 10. |
| description | string | required | What this payment is for (shown to the buyer, ≤200 chars) |
| customer_email | string | optional | Optional buyer email. |
| reference_id | string | optional | Your unique order reference (≤40 chars). Auto-generated if omitted. |
| success_url | string | optional | Optional https URL to send the buyer to after payment. |
Raw schema
{
"type": "object",
"properties": {
"amount_npr": {
"type": "number",
"minimum": 10,
"maximum": 1000000,
"description": "Amount in NPR (decimals allowed), e.g. 100. Minimum 10."
},
"description": {
"type": "string",
"description": "What this payment is for (shown to the buyer, ≤200 chars)"
},
"customer_email": {
"type": "string",
"description": "Optional buyer email."
},
"reference_id": {
"type": "string",
"description": "Your unique order reference (≤40 chars). Auto-generated if omitted."
},
"success_url": {
"type": "string",
"description": "Optional https URL to send the buyer to after payment."
}
},
"required": [
"amount_npr",
"description"
]
}