Create payment
payments_create_paymentCreates a gateway payment order or session and returns checkout instructions so the frontend can render an SDK, redirect the browser, or submit a form.
Instructions
Create an order / payment session. Returns checkout, which tells the frontend what to do: js_sdk (load script + options), redirect (send the browser to url), form_post (auto-submit a form with fields), or manual. Persist orderRef + providerOrderId.
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": {
"provider": "<provider>",
"order_ref": "<order_ref>",
"amount": "<amount>"
},
"name": "payments_create_payment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Integer minor units (paise). Rs 499.00 = 49900 | |
| currency | No | ISO 4217, default INR | |
| customer | No | ||
| metadata | No | ||
| provider | Yes | Gateway id | |
| order_ref | Yes | Merchant reference: 3-40 chars, letters/digits/_/- | |
| notify_url | No | Server-to-server notification URL where the gateway takes it per request | |
| return_url | No | Browser redirect after payment (required for PayU, CCAvenue, Paytm, PhonePe, Stripe Checkout) | |
| description | No | ||
| include_raw | No | Include the untouched provider response (verbose). | |
| idempotency_key | No | Defaults to order_ref | |
| provider_options | No | Provider-specific fields merged into the request |