Create payment
create_paymentDestructive
Create a YooKassa payment and get a confirmation URL for redirect, embedded, or QR confirmation. Supports one-step and two-step payments, receipts, and metadata.
Instructions
Create a payment in YooKassa. Returns a confirmation URL. Supports one-step and two-step payments, receipts, and metadata. MOVES REAL MONEY (the payer is charged) — irreversible.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Payment amount in rubles (string '5000.00' for exactness, or a number) | |
| capture | No | true = one-step (auto-capture), false = two-step (hold) | |
| currency | No | Currency (ISO-4217, default RUB) | RUB |
| metadata | No | Arbitrary metadata (key-value) | |
| return_url | No | URL to return the payer to after payment — REQUIRED when confirmation_type=redirect | |
| description | Yes | Payment description (max 128 chars) | |
| receipt_email | No | Customer email for the receipt | |
| receipt_items | No | Items for a 54-FZ receipt (if issuing a receipt with the payment) | |
| confirmation_type | No | Confirmation type: redirect (needs return_url), embedded (widget), or qr | redirect |
| payment_method_type | No | Payment method | |
| receipt_tax_system_code | No | Receipt tax system code, tag 1055 (only if the shop has multiple tax systems / FFD 1.2) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| paid | No | ||
| amount | No | ||
| status | No | ||
| confirmation_url | No |