Skip to content

1Payment API (1.0.0)

This API allows partners to initiate and manage payments, payouts, check statuses, and interact with the payment form. It also provides access to balance and refund operations.

Overview
1Payment API Support

admin@1payment.com

License

Proprietary License

Languages
Servers
Mock server

https://doc.nova.1payment.com/_mock/apis/

Test server

https://api.test.nova.1payment.com/

webhooks

Webhooks

Payment status changedWebhook

Request

Sent when the status of a payment is updated. For example, from PENDING to SUCCESS or FAILURE.

Security
timestamp and signature
Bodyapplication/jsonrequired
eventstringrequired
Example: "payment.status_changed"
order_idstringrequired
Example: "cpm_abc123"
statusintegerrequired
Example: 3
status_descriptionstringrequired
Example: "SUCCESS"
status_codeintegerrequired
Example: 0
amountnumber(float)required
Example: 100
user_datastring
Example: "partner-123"

Payout status changedWebhook

Request

Sent when the status of a payout is updated.

Security
timestamp and signature
Bodyapplication/jsonrequired
eventstringrequired
Example: "payout.status_changed"
order_idstringrequired
Example: "cpm_abc123"
statusintegerrequired
Example: 3
status_descriptionstringrequired
Example: "SUCCESS"
status_codeintegerrequired
Example: 0
amountnumber(float)required
Example: 100
user_datastring
Example: "partner-123"

Refund status changedWebhook

Request

Sent when the status of a refund is updated.

Security
timestamp and signature
Bodyapplication/jsonrequired
eventstringrequired
Example: "refund.status_changed"
order_idstringrequired
Example: "cpm_abc123"
statusintegerrequired
Example: 3
status_descriptionstringrequired
Example: "SUCCESS"
status_codeintegerrequired
Example: 0
amountnumber(float)required
Example: 100
user_datastring
Example: "partner-123"

init_payment/{type}

Request

Security
timestamp and signature
Path
typestringrequired

Payment type

Enum"card""sbp""crypto""mc"
Bodyapplication/jsonrequired
One of:
partner_idinteger(partner_id)required

Partner identifier

Example: 1234
project_idinteger(project_id)required

Project identifier

Example: 5678
amountnumber(decimal)(amount)required

Amount in the currency associated with the project.

Example: 100
user_datastring(user_data)required

Unique identifier on partner side

Example: "uda-123"
card_dataobject(card_data)
browserobject(browser)
payerobject(payer)
payeeobject(payee)
curl -i -X POST \
  'https://doc.nova.1payment.com/_mock/apis/init_payment/{type}' \
  -H 'Content-Type: application/json' \
  -H 'signature: YOUR_API_KEY_HERE' \
  -H 'timestamp: YOUR_API_KEY_HERE' \
  -d '{
    "partner_id": 1234,
    "project_id": 5678,
    "user_data": "uda-123",
    "amount": 100
  }'

Responses

Unified response for all outcomes. On success, the response contains payment initialization details including the transaction ID and status. On error, the response includes an error code and message describing the issue.

Bodyapplication/json
One of:
order_idstring(uuid)required

Unique identifier of the payment.

Example: "8p3brmb19gfg0sg8gcwhws8kgc748s87"
statusintegerrequired

Numeric status of the payment.

Example: 2
status_codeintegerrequired

Internal status code.

Example: 0
redirect_urlstring(uri)

Optional redirection URL for further user interaction.

Example: "https://qr.nspk.ru/XXX"
Response
application/json
{
  "order_id": "8p3brmb19gfg0sg8gcwhws8kgc748s87",
  "status": 2,
  "status_code": 0,
  "redirect_url": "https://qr.nspk.ru/XXX"
}

status_payment

Request

Security
timestamp and signature
Bodyapplication/jsonrequired
One of:
order_idstringrequired

Unique order ID assigned by the system

partner_idinteger(partner_id)required

Partner identifier

project_idinteger(project_id)required

Project identifier

curl -i -X POST \
  https://doc.nova.1payment.com/_mock/apis/status_payment \
  -H 'Content-Type: application/json' \
  -H 'signature: YOUR_API_KEY_HERE' \
  -H 'timestamp: YOUR_API_KEY_HERE' \
  -d '{
    "order_id": "string",
    "partner_id": 1234,
    "project_id": 5678
  }'

Responses

Returns the current status of a previously initiated payment. Provide either order_id or user_data. Useful for checking payment progress or final state if callback was missed.

Bodyapplication/json
One of:
partner_idinteger(partner_id)

Partner identifier

project_idinteger(project_id)

Project identifier

amountnumber(decimal)(amount)

Amount in the currency associated with the project.

descriptionstring(description)

Description of the transaction.

user_datastring(user_data)

Unique identifier on partner side

order_idstring(order_id)

Unique identifier on system side

Response
application/json
{
  "partner_id": 1234,
  "project_id": 5678,
  "amount": 50,
  "description": "Payment for order #42",
  "user_data": "abc-123",
  "order_id": "abc-123"
}

init_payout

Request

Security
timestamp and signature
Bodyapplication/jsonrequired
partner_idinteger(partner_id)required

Partner identifier

project_idinteger(project_id)required

Project identifier

amountnumber(decimal)(amount)required

Amount in the currency associated with the project.

destinationstring(destination)required

Recipient's account identifier, such as card number, phone number, or other destination depending on payout type.

user_datastring(user_data)required

Unique identifier on partner side

curl -i -X POST \
  https://doc.nova.1payment.com/_mock/apis/init_payout \
  -H 'Content-Type: application/json' \
  -H 'signature: YOUR_API_KEY_HERE' \
  -H 'timestamp: YOUR_API_KEY_HERE' \
  -d '{
    "partner_id": 1234,
    "project_id": 5678,
    "amount": 50,
    "destination": "79001234567",
    "user_data": "abc-123"
  }'

Responses

Unified response for all outcomes. On success, the response contains payment initialization details including the transaction ID and status. On error, the response includes an error code and message describing the issue.

Bodyapplication/json
One of:
order_idstring(order_id)required

Unique identifier on system side

statusintegerrequired

Numeric status of the payment.

Example: 2
status_codeintegerrequired

Internal status code.

Example: 0
Response
application/json
{
  "order_id": "abc-123",
  "status": 2,
  "status_code": 0
}

status_payout

Request

Security
timestamp and signature
Bodyapplication/jsonrequired
One of:
order_idstringrequired

Unique order ID assigned by the system

partner_idinteger(partner_id)required

Partner identifier

project_idinteger(project_id)required

Project identifier

curl -i -X POST \
  https://doc.nova.1payment.com/_mock/apis/status_payout \
  -H 'Content-Type: application/json' \
  -H 'signature: YOUR_API_KEY_HERE' \
  -H 'timestamp: YOUR_API_KEY_HERE' \
  -d '{
    "order_id": "string",
    "partner_id": 1234,
    "project_id": 5678
  }'

Responses

Status of the payout request

Bodyapplication/json
One of:
partner_idinteger(partner_id)

Partner identifier

project_idinteger(project_id)

Project identifier

amountnumber(decimal)(amount)

Amount in the currency associated with the project.

descriptionstring(description)

Description of the transaction.

user_datastring(user_data)

Unique identifier on partner side

order_idstring(order_id)

Unique identifier on system side

Response
application/json
{
  "partner_id": 1234,
  "project_id": 5678,
  "amount": 50,
  "description": "Payment for order #42",
  "user_data": "abc-123",
  "order_id": "abc-123"
}

init_form

Request

Security
timestamp and signature
Bodyapplication/jsonrequired
partner_idinteger(partner_id)required

Partner identifier

Example: 1234
project_idinteger(project_id)required

Project identifier

Example: 5678
amountnumber(decimal)(amount)required

Amount in the currency associated with the project.

Example: 100
user_datastring(user_data)required

Unique identifier on partner side

Example: "uda-123"
card_dataobject(card_data)
browserobject(browser)
payerobject(payer)
payeeobject(payee)
curl -i -X POST \
  https://doc.nova.1payment.com/_mock/apis/init_form \
  -H 'Content-Type: application/json' \
  -H 'signature: YOUR_API_KEY_HERE' \
  -H 'timestamp: YOUR_API_KEY_HERE' \
  -d '{
    "partner_id": 1234,
    "project_id": 5678,
    "user_data": "uda-123",
    "amount": 100
  }'

Responses

Payment form URL

Bodyapplication/json
redirect_urlstring(uri)
Example: "https://pay.example.com/form/xyz"
Response
application/json
{
  "redirect_url": "https://pay.example.com/form/xyz"
}

init_invoice

Request

Security
timestamp and signature
Bodyapplication/jsonrequired
partner_idinteger(partner_id)required

Partner identifier

Example: 1234
project_idinteger(project_id)required

Project identifier

Example: 5678
amountnumber(decimal)(amount)required

Amount in the currency associated with the project.

Example: 100
user_datastring(user_data)required

Unique identifier on partner side

Example: "uda-123"
card_dataobject(card_data)
browserobject(browser)
payerobject(payer)
payeeobject(payee)
curl -i -X POST \
  https://doc.nova.1payment.com/_mock/apis/init_invoice \
  -H 'Content-Type: application/json' \
  -H 'signature: YOUR_API_KEY_HERE' \
  -H 'timestamp: YOUR_API_KEY_HERE' \
  -d '{
    "partner_id": 1234,
    "project_id": 5678,
    "user_data": "uda-123",
    "amount": 100
  }'

Responses

Invoice created

Bodyapplication/json
invoice_urlstring(uri)
Example: "https://invoice.example.com/i/abc123"
order_idstring
Example: "inv_123456789"
Response
application/json
{
  "invoice_url": "https://invoice.example.com/i/abc123",
  "order_id": "inv_123456789"
}

get_balance

Request

Security
timestamp and signature
Bodyapplication/jsonrequired
partner_idinteger(partner_id)required

Partner identifier

project_idinteger(project_id)required

Project identifier

curl -i -X POST \
  https://doc.nova.1payment.com/_mock/apis/get_balance \
  -H 'Content-Type: application/json' \
  -H 'signature: YOUR_API_KEY_HERE' \
  -H 'timestamp: YOUR_API_KEY_HERE' \
  -d '{
    "partner_id": 1234,
    "project_id": 5678
  }'

Responses

Balance information

Bodyapplication/json
payout_balancenumber(float)
Example: 1200.5
expected_balancenumber(float)
Example: 1350
currencystring
Example: "RUB"
Response
application/json
{
  "payout_balance": 1200.5,
  "expected_balance": 1350,
  "currency": "RUB"
}
© 2025 1payment.com. All rights reserved.