General information
Welcome to the 1Payment API documentation.
Base URL
https://api.1payment.comBefore integration, obtain your project API key in the merchant dashboard and review the API request format: HTTP method, parameters, sign signature, and callback handling.
Reference
API request formatGET, POST, JSON, sign signature, and callback verification.
Error codes (API)error_code in API responses, including signature errors.
Error codes (declines)status_code when the bank or payment system declines.
Payment typespayment_type values: card, sbp, sberpay, and others.
Payout typesPayout channels and the payout_type parameter.
Transaction statusesSUCCESS, PENDING, FAILURE, and refund codes.
Balance requestget_balance method for partner projects.
Exchange rateget_rate — conversion rate between project currencies.
Create invoiceinit_invoice — payment invoice and form link.
Accepting payments
Choose a channel enabled on your project. Each method in the documentation includes parameters, signature, code examples, and a sign verification widget.
Cards
Form paymentinit_form — redirect the payer to the payment form.
Host2host (GATE)init_payment — card charge without redirect.
SubscriptionsRecurring charges by token.
Refundsinit_refund — full or partial refund.
Payment statusstatus_payment by order_id or user_data.
SBP
Form paymentQR code and payment via the bank app.
Host2host (GATE)Direct SBP payment initiation.
SubscriptionsSBP recurring payments.
RefundsSBP refund processing.
Payment statusSBP operation status polling.
Link payments
Form paymentRedirect to the payment page via link.
Host2host (GATE)Direct payment initiation (payment_type=link).
SubscriptionsRecurring link payments.
RefundsRefund via the link channel.
Payment statusOperation status polling (payment_type=link).
ERIP
Form paymentQR code and payment via ERIP.
Host2host (GATE)Direct ERIP payment initiation.
SubscriptionsERIP recurring payments.
RefundsERIP refund processing.
Payment statusERIP operation status polling.
SberPay
Form paymentRedirect to the SberPay flow.
Host2host (GATE)App2App and other flows without a form.
SubscriptionsSberPay recurring charges.
RefundsSberPay payment refund.
Payment statusStatus check via API.
Payouts
Card payoutinit_payout with payout_type=card.
PIXinit_payout with payout_type=pix, Tax ID / CPF.
SEPAinit_payout with payout_type=sepa, IBAN and recipient details.
FPSinit_payout with payout_type=fps, account and sort code.
SBPinit_payout with payout_type=sbp, phone and bank_id.
Payout statusstatus_payout by payout order_id.
How the documentation is organized
| Section on the method page | Contents |
|---|---|
| How it works | Business and user scenario |
| Technical details | URL, HTTP method, body format |
| Request parameters | Required and optional fields |
| Signature generation | MD5 formula and verification widget |
| Request examples | Node.js, Python, PHP, cURL |
| Notifications (callbacks) | POST JSON to your notify_url |
Request and callback signatures are described in API request format. Each operation page includes an interactive sign verification tool.