{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/en/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["docHero","docCards","docCard"]},"type":"markdown"},"seo":{"title":"General information","description":"Документация API 1Payment — приём платежей и выплаты.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"general-information","__idx":0},"children":["General information"]},{"$$mdtype":"Tag","name":"DocHero","attributes":{"lede":"Welcome to the 1Payment API documentation.","endpoint":"https://api.1payment.com"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before integration, obtain your project ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API key"]}," in the merchant dashboard and review the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pages/init-request"},"children":["API request format"]},": HTTP method, parameters, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sign"]}," signature, and callback handling."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reference","__idx":1},"children":["Reference"]},{"$$mdtype":"Tag","name":"DocCards","attributes":{},"children":[{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/init-request.md","title":"API request format","description":"GET, POST, JSON, sign signature, and callback verification."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/error-codes-api.md","title":"Error codes (API)","description":"error_code in API responses, including signature errors."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/decline-error-codes.md","title":"Error codes (declines)","description":"status_code when the bank or payment system declines."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/payment-types.md","title":"Payment types","description":"payment_type values: card, sbp, sberpay, and others."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/payout-types.md","title":"Payout types","description":"Payout channels and the payout_type parameter."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/transaction-statuses.md","title":"Transaction statuses","description":"SUCCESS, PENDING, FAILURE, and refund codes."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/balance.md","title":"Balance request","description":"get_balance method for partner projects."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/get-rate.md","title":"Exchange rate","description":"get_rate — conversion rate between project currencies."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/init-invoice.md","title":"Create invoice","description":"init_invoice — payment invoice and form link."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"accepting-payments","__idx":2},"children":["Accepting payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose a channel enabled on your project. Each method in the documentation includes parameters, signature, code examples, and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sign"]}," verification widget."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cards","__idx":3},"children":["Cards"]},{"$$mdtype":"Tag","name":"DocCards","attributes":{},"children":[{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/card/init-form.md","title":"Form payment","description":"init_form — redirect the payer to the payment form."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/card/host2host.md","title":"Host2host (GATE)","description":"init_payment — card charge without redirect."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/card/recurring.md","title":"Subscriptions","description":"Recurring charges by token."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/card/refund.md","title":"Refunds","description":"init_refund — full or partial refund."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/card/status.md","title":"Payment status","description":"status_payment by order_id or user_data."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sbp","__idx":4},"children":["SBP"]},{"$$mdtype":"Tag","name":"DocCards","attributes":{},"children":[{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/sbp/init-form.md","title":"Form payment","description":"QR code and payment via the bank app."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/sbp/host2host.md","title":"Host2host (GATE)","description":"Direct SBP payment initiation."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/sbp/recurring.md","title":"Subscriptions","description":"SBP recurring payments."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/sbp/refund.md","title":"Refunds","description":"SBP refund processing."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/sbp/status.md","title":"Payment status","description":"SBP operation status polling."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"link-payments","__idx":5},"children":["Link payments"]},{"$$mdtype":"Tag","name":"DocCards","attributes":{},"children":[{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/link/init-form.md","title":"Form payment","description":"Redirect to the payment page via link."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/link/host2host.md","title":"Host2host (GATE)","description":"Direct payment initiation (payment_type=link)."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/link/recurring.md","title":"Subscriptions","description":"Recurring link payments."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/link/refund.md","title":"Refunds","description":"Refund via the link channel."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/link/status.md","title":"Payment status","description":"Operation status polling (payment_type=link)."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"erip","__idx":6},"children":["ERIP"]},{"$$mdtype":"Tag","name":"DocCards","attributes":{},"children":[{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/erip/init-form.md","title":"Form payment","description":"QR code and payment via ERIP."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/erip/host2host.md","title":"Host2host (GATE)","description":"Direct ERIP payment initiation."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/erip/recurring.md","title":"Subscriptions","description":"ERIP recurring payments."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/erip/refund.md","title":"Refunds","description":"ERIP refund processing."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/erip/status.md","title":"Payment status","description":"ERIP operation status polling."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sberpay","__idx":7},"children":["SberPay"]},{"$$mdtype":"Tag","name":"DocCards","attributes":{},"children":[{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/sberpay/init-form.md","title":"Form payment","description":"Redirect to the SberPay flow."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/sberpay/host2host.md","title":"Host2host (GATE)","description":"App2App and other flows without a form."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/sberpay/recurring.md","title":"Subscriptions","description":"SberPay recurring charges."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/sberpay/refund.md","title":"Refunds","description":"SberPay payment refund."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/sberpay/status.md","title":"Payment status","description":"Status check via API."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payouts","__idx":8},"children":["Payouts"]},{"$$mdtype":"Tag","name":"DocCards","attributes":{},"children":[{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/payouts/card.md","title":"Card payout","description":"init_payout with payout_type=card."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/payouts/pix.md","title":"PIX","description":"init_payout with payout_type=pix, Tax ID / CPF."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/payouts/sepa.md","title":"SEPA","description":"init_payout with payout_type=sepa, IBAN and recipient details."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/payouts/fps.md","title":"FPS","description":"init_payout with payout_type=fps, account and sort code."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/payouts/sbp.md","title":"SBP","description":"init_payout with payout_type=sbp, phone and bank_id."},"children":[]},{"$$mdtype":"Tag","name":"DocCard","attributes":{"href":"./pages/payouts/status.md","title":"Payout status","description":"status_payout by payout order_id."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-the-documentation-is-organized","__idx":9},"children":["How the documentation is organized"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Section on the method page"},"children":["Section on the method page"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Contents"},"children":["Contents"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How it works"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Business and user scenario"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Technical details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL, HTTP method, body format"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request parameters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required and optional fields"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Signature generation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["MD5 formula and verification widget"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request examples"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Node.js, Python, PHP, cURL"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notifications (callbacks)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST JSON to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notify_url"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Request and callback signatures are described in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pages/init-request"},"children":["API request format"]},". Each operation page includes an interactive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sign"]}," verification tool."]}]},"headings":[{"value":"General information","id":"general-information","depth":1},{"value":"Reference","id":"reference","depth":2},{"value":"Accepting payments","id":"accepting-payments","depth":2},{"value":"Cards","id":"cards","depth":3},{"value":"SBP","id":"sbp","depth":3},{"value":"Link payments","id":"link-payments","depth":3},{"value":"ERIP","id":"erip","depth":3},{"value":"SberPay","id":"sberpay","depth":3},{"value":"Payouts","id":"payouts","depth":2},{"value":"How the documentation is organized","id":"how-the-documentation-is-organized","depth":2}],"frontmatter":{"seo":{"title":"General information"}},"lastModified":"2026-07-09T09:48:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}