Create Invoice

Create a new invoice.

POST

***

Request Parameters

Name	Type	Description
`public_key`Required	`String`	Merchant identifier. Example: `i000000001`
`sum`Required	`Number`	Payment amount. Example: `100`, `20.50`
`display`Required	`Number`	Display the invoice. Values: `1` or `0`
`save_as_template`Required	`Number`	Save as template. Values: `1` or `0`
`status_installment`Optional	`Number`	Enable installment payment. Values: `1` or `0`
`name`Optional	`String`	Name
`description`Optional	`String`	Payment description.
`phone`Optional	`String`	Phone number.
`email`Optional	`String`	Email address.
`inn`Optional	`String`	Tax identification number (VOEN).
`contract_number`Optional	`String`	Contract number.
`merchant_order_id`Optional	`String`	Merchant order ID.
`period_from`Required	`Date`	Invoice start date.
`period_to`Required	`Date`	Invoice end date.

Request Example

Send Request

Payload

{
  "public_key": "i000000001",
  "sum": 100,
  "display": 1,
  "save_as_template": 0,
  "name": "John Doe",
  "description": "Service payment",
  "period_from": "2024-01-01",
  "period_to": "2024-12-31"
}

1DATA=$(echo -n '{"public_key":"i000000001","sum":100,"display":1,"save_as_template":0,"name":"John Doe","description":"Service payment","period_from":"2024-01-01","period_to":"2024-12-31"}' | base64)
2SIGNATURE=$(echo -n "$PRIVATE_KEY$DATA$PRIVATE_KEY" | openssl dgst -sha1 -binary | base64)
3
4curl -X POST *** \
5-H "Content-Type: application/x-www-form-urlencoded" \
6-d "data=$DATA&signature=$SIGNATURE"

Response Parameters

Name	Type	Description
`status`Required	`String`	Operation result: `success` or `error`
`id`Optional	`Number`	Created invoice ID. Present on success.
`message`Optional	`String`	Error description. Present on failure.
`trace_id`Required	`String`	Unique request identifier for debugging. Provide this to Epoint support for issue investigation.

Response

1{
2  "status": "success",
3  "id": 12345,
4  "trace_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
5}