Bill¶

Bill object description and API calls for work with user's bills.

Bill object¶

{
  "order_id": 63602,
  "created": "2012-03-05 11:55:03",
  "sum": 150.0,
  "status": "created",
  "positions": ["The subscription fee for the services of Account W3"],
  "link": "http://bill.gdemoi.ru/xK1QEYK"
}

• order_id - int. Unique bill ID.
• created - date/time. When the bill created.
• sum - float. A bill sum in default currency of the panel.
• status - enum. Bill order status. Can be one of:
  • created – but not settled.
  • settled.
  • canceled.
• positions - string array. List of position names. Usually contains one element for a bill.
• link - string. URL to order.

API actions¶

API path: /bill.

create¶

Creates a new bill for the user.

required sub-user rights: payment_create.

Parameters¶

Example¶

curl -X POST 'https://api.gdemoi.ru/v2/bill/create' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "payer": "Jon Doe", "sum": 100.0}'

Response¶

{
  "success": true,
  "value": 6421
}

• value - int. Created bill ID.

Errors¶

• 222 – Plugin not found - when plugin 29 not available for user.

list¶

Shows list of bills with their parameters in array.

required sub-user rights: payment_create.

Parameters¶

Examples¶

curl -X POST 'https://api.gdemoi.ru/v2/bill/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b"}'

https://api.gdemoi.ru/v2/bill/list?hash=a6aa75587e5c59c32d347da438505fc3

Response¶

{
  "success": true,
  "count": 7,
  "bills": [
    {
      "order_id": 63602,
      "created": "2012-03-05 11:55:03",
      "sum": 150.0,
      "status": "created",
      "positions": ["The subscription fee for the services of Account W3"],
      "link": "http://bill.gdemoi.ru/xK1QEYK"
    }
  ]
}

• count - int. Total number of bills.
• bills - array of objects. A list of bill objects.

If bill created using /bill/create call then positions will contain exactly one element.

Errors¶

• 222 – Plugin not found - when plugin 29 not available for user.