API v1.0.0 Objects
Koshelek Pay API
Documentation has moved
The information on this page is no longer updated and may be obsolete. The most current Koshelek documentation is now available at the new address:
1. CheckoutInvoice
Object contains checkout invoice data.
Field | Type | Mandatory | Description |
---|---|---|---|
| String | Yes | Invoice ID in merchant's system (up to 36 characters). |
| Number | Yes | Total amount in kopecks (10 characters — only digits, non-negative number). Spaces are not allowed. |
| Number | No | Discount amount in kopecks (10 characters — only digits, non-negative number). Spaces are not allowed. |
| Number | No | Total amount excluding discount in kopecks. (10 characters — only digits, non-negative number). Spaces are not allowed. |
| Array of Item | Yes | Array of Item objects describing commodity items. |
2. Item
Object defines particular commodity item to be paid with Koshelek Pay.
Field | Type | Mandatory | Description |
---|---|---|---|
| String | Yes | Item name. |
| String | Yes | Item article. |
| Number | Yes | Price for one item in kopecks. |
| Number | Yes | Number. |
| Number | Yes | Total amount in kopecks. Spaces are not allowed. |
| Number | No | Discount amount in kopecks. Spaces are not allowed. |
| Number | No | Total amount excluding discount in kopecks. Spaces are not allowed. |
| Enum | Yes | Tax rate:
|
3. User
Object describes a loyalty program user (customer).
Field | Type | Mandatory | Description |
---|---|---|---|
| String | Yes | Customer loyalty ID (e.g., presented loyalty card number) (up to 36 characters). |
4. PaymentTypeAvailabilityInfo
Object containing available payment method info.
Field | Type | Mandatory | Description |
---|---|---|---|
| String | Yes | Payment method name (up to 36 characters). |
| Boolean | Yes | Indicates payment method availability:
|
| String | No | Additional information on payment method. |
5. Slip
Object contains information about completed transaction.
Field | Type | Mandatory | Description |
---|---|---|---|
| String | Yes | Slip object ID in Koshelek Pay. |
| Enum | Yes | Payment mechanism:
|
| String | Yes | Store ID (see API Connection). |
| String | Yes | Terminal ID. |
| String | Yes | Invoice ID in merchant's system. |
| String | Yes | Payment transaction ID in Koshelek Pay. |
| String | No | Refund transaction ID. |
| String | Yes (for | Merchant ID presented by recipient bank. Mandatory for |
| String | No | Control operation value that may be returned for successful |
| Date | Yes | Date in format:
|
| String | No | Transaction ID assigned by bank. |
| String | Yes (for | Transaction ID assigned by Faster Payments System. Mandatory for |
| Number | Yes | Paid amount in kopecks. Spaces are not allowed. |
6. PaymentMethod
Object defines payment method used in transaction.
Field | Type | Mandatory | Description |
---|---|---|---|
| Enum | Yes | Payment mechanism:
|
| Object | No | Object for extra fields (e.g. discounts, bonuses etc.) in a "key-value" format. |
| String | No | "Payment purpose" value applicable to |
7. Invoice
Object describes an invoice (receipt).
Field | Type | Mandatory | Description |
---|---|---|---|
| String | Yes | Invoice number (up to 36 characters). |
| String | Yes | Receipt number (up to 36 characters). |
| String | Yes | Merchant full name (up to 999 characters). |
| String | Yes | Merchant address (up to 999 characters). |
| String | Yes | Merchant TIN (12 digits, opening with 2 zeroes for legal entities. |
| Datetime | Yes | Date in format: YYYY-MM-DDTHH24:MI:SS+GMT |
| String | Yes | Work shift (up to 32 characters). |
| String | Yes | Checkout operator number or name (up to 256 characters). |
| Enum | No | Taxation system (TS):
|
| String | No | Cash register number (up to 64 characters). |
| String | No | Fiscal memory device number (up to 64 characters). |
| String | No | Fiscal attribute of document (up to 64 characters). |
| String | No | Fiscal document number (up to 64 characters). |
| String | No | Web site for receipt verification (e.g. nalog.ru) (up to 64 characters). |
| Enum | Yes | Receipt type:
|
| Number | Yes | Total amount in kopecks (up to 10 digits, non-negative integer). Spaces are not allowed. |
| Number | No | Discount amount in kopecks (up to 10 digits, non-negative integer). Spaces are not allowed. |
| Number | No | Total amount excluding discount in kopecks (10 digits, non-negative integer). Spaces are not allowed. |
| Number | Yes | Tax amount in kopecks (up to 10 characters — only digits, non-negative integer). Spaces are not allowed. |
| String | No | QR for receipt in digital (up to 999 characters). |
| Array of Item | Yes | Array of Item objects describing purchased items. |
Last updated