# First steps in the 1Payment personal account Step-by-step guide to signing in, configuring your project, and using the main sections of the [personal account](https://account.1payment.com/personal/login). For API integration, see [Documentation](/). ## What you need - Login and password issued when you connect to 1Payment. - Access to the partner personal account: [account.1payment.com](https://account.1payment.com/personal/login). - For staff — separate sign-in: [clientpanel.1payment.com](https://clientpanel.1payment.com/). --- ## Initial setup ### Sign in to the personal account After receiving your credentials, open the sign-in page and enter your login and password: ![1Payment personal account sign-in page](https://i.postimg.cc/265KYCdY/1.jpg) ### Project API key 1. Go to [**Projects**](https://account.1payment.com/projects). 2. Open project editing (pencil icon). 3. Set the project **API key** if each site or project uses a separate key. ![Projects section in the personal account](https://i.postimg.cc/1RMjHHSP/2.jpg) ![API key configuration in the project card](https://i.postimg.cc/9QPTdx3Y/3.jpg) If the API key is **not set** for a project, the **global** key from [**Settings** → **API settings**](https://account.1payment.com/account/settings-api) is used: ![Global API key in account settings](https://i.postimg.cc/P5LfhJyp/4.jpg) The key is required to sign API requests — see [API request format](/pages/init-request). ### Callbacks (`notify_url`) Set `notify_url` in project settings to receive transaction status notifications: ![notify_url field in project settings](https://i.postimg.cc/SNnbY5MH/5.jpg) 1Payment sends POST callbacks with payment data. Your server must respond with **`HTTP 200 OK`**. Format and signature verification — in [API request format](/pages/init-request). ### SUCCESS and FAIL URLs (payment form) When integrating via the **payment form**, you can set URLs to redirect the payer after successful or failed payment: ![SUCCESS and FAIL URLs in project settings](https://i.postimg.cc/nV5wgLXw/6.jpg) ### Payment form and GATE (host2host) - **Payment form** — redirect the user to the 1Payment page ([example: init_form](/pages/card/init-form)). - **GATE (host2host)** — charge without redirect; **PCI DSS** certificate is required. Contact your account manager and see [API documentation](/pages/card/host2host). ### Payment and payout fees The **Payment fees** and **Payout fees** tabs show enabled methods, per-transaction fee, minimum and maximum amounts, and settlement times: ![Payment acceptance fees](https://i.postimg.cc/cCwxYbKR/22.jpg) ![Payout fees](https://i.postimg.cc/nhHFjTnm/23.jpg) --- ## Dashboard Summary transaction statistics for a period: **Today**, **Week**, **Last week**, **Month**, **Last month**, or a custom range (**Select period**). ![Dashboard — chart and filters](https://i.postimg.cc/zXCx9VQC/7.jpg) In the site header: - **blue** — balance available for withdrawal; - **gray** — total balance. Funds from the previous day are credited to the available balance at **11:00 (MSK)** on the current day. ![Balance in the personal account header](https://i.postimg.cc/3RjyKQQc/8.jpg) --- ## Statistics Search payments by **phone**, **account**, **transaction number** (`order_id` or `user_data`). Export to **CSV**, filter by project and payment method: ![Statistics section](https://i.postimg.cc/0NbFR9D9/10.jpg) For a selected transaction you can: - request a **refund** (full or partial, with amount); - view **refund attempt history**. ![Transaction refund dialog](https://i.postimg.cc/4NRYYdxF/9.jpg) ![Refund attempt history](https://i.postimg.cc/GpT85S3H/7.jpg) Refunds via API are described in [refund documentation](/pages/card/refund). --- ## Payouts Payout statistics for a period, transaction search, status filter, **CSV** export by initiation time or status time: ![Payouts section](https://i.postimg.cc/mD2xrKcr/11.jpg) Initiate payouts via API — in the [Payouts](/pages/payouts/card) documentation section. --- ## Disputes List of **chargeback** cases. Respond by attaching documents: **Files** → **Send**. ![Disputes list](https://i.postimg.cc/7hzyv0G1/12.jpg) ![Attach files to a dispute](https://i.postimg.cc/tggQqLn4/12-1.jpg) --- ## Reporting Project currency, balance credit history (by default funds are available for payout **the next day**), **holds** (chargeback reserves): ![Reporting — balance and credits](https://i.postimg.cc/4N41SZDy/13.jpg) ![Holds in reporting](https://i.postimg.cc/tJqFwtmw/14.jpg) Configure automatic payment registry email delivery: ![Automatic registry email delivery](https://i.postimg.cc/K86BxyHn/15.jpg) --- ## Staff Add staff members with access to sections: statistics, projects, payouts, disputes, reporting, refund access. **Staff sign-in:** [https://clientpanel.1payment.com](https://clientpanel.1payment.com/) ![Add staff member](https://i.postimg.cc/6397p6LG/16.jpg) ![Staff access permissions](https://i.postimg.cc/ht1QW7Vq/16.jpg) --- ## Wallets Before adding a payout wallet (USDT or card), **enable 2FA** in [**Settings** → **Security**](https://account.1payment.com/account/settings-security): ![Enable 2FA before adding a wallet](https://i.postimg.cc/W1YjkNvk/27.jpg) Available payout methods depend on enabled channels — confirm with your 1Payment account manager. | Field | Description | | --- | --- | | **Credential** | Payment details (required). | | **Description** | Optional label for the saved wallet. | ![Add payout wallet](https://i.postimg.cc/ZnQFNvVQ/28.jpg) --- ## Settings ### Profile Contact details: name, phone, Skype, Telegram. ![Profile tab](https://i.postimg.cc/tCC4Zmx8/17.jpg) ### Security and 2FA Change password, enable and disable **two-factor authentication (2FA)**. Four modes are available: 1. No 2FA. 2. 2FA via **email**. 3. 2FA via **QR code** (authenticator app). 4. 2FA via **both email and QR code**. The QR code is shown when **enabling** the corresponding option. For staff, the QR is shown at sign-in if the partner enabled this option for them. At sign-in, a **session identifier** (4 digits) is displayed so you enter the code for the correct session. A session lasts **60 seconds**; resending the email is possible after the timer on the code entry page expires. ![Security tab](https://i.postimg.cc/9f32pxDm/18.jpg) ### API settings Global **API KEY** for all projects (if no project-level key is set): ![API settings tab](https://i.postimg.cc/KjWwYzLG/19.jpg) ### Activity Sign-in log: time, IP, browser. ![Activity tab](https://i.postimg.cc/R0m8h23H/20.jpg) ### IP allowlist Add IPs from which API requests are allowed. After adding **at least one** address, requests from other IPs are **rejected**: ![Partner IP allowlist](https://i.postimg.cc/NGnzmK9Y/21.jpg) ### Our IP addresses IPs from which 1Payment sends **callbacks**. Add them to your allowlist (for example, when using Cloudflare): ![1Payment callback IP addresses](https://i.postimg.cc/HnXp1y3T/24.jpg) --- ## Support - Email: [support@1payment.com](mailto:support@1payment.com) - Telegram: [t.me/onepayment_support](https://t.me/onepayment_support) - Tickets in the personal account: [tickets](https://account.1payment.com/tickets)