Create a test payment
create_test_paymentGenerate a KHQR test payment with a hosted checkout page using a kp_test_ key. Returns checkout_url and expires_at so you can simulate payment events during integration.
Instructions
Creates a KHQRPay test payment: a KHQR that no bank will pay, with a hosted checkout page. Only with a kp_test_ key: this server never creates live payments. Returns the payment, including checkout_url and expires_at. Move it with simulate_test_payment; the store's test webhook endpoints get the events.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"amount": "<amount>"
},
"name": "create_test_payment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Dollars with up to 2 decimals ("16.88"), or whole riel ("5000"). | |
| currency | No | The currency the amount is in. | USD |
| metadata | No | Your own JSON object: up to 50 keys and 4 KB. | |
| reference_id | No | Your order id, as a string. |