Difference between revisions of "MOR API card from group sell"
From Kolmisoft Wiki
Jump to navigationJump to search
(No difference)
|
Revision as of 05:27, 27 May 2013
Description
MOR API sells Cards from Calling Card Group
Usage
- Call: /api/card_from_group_sell
- For Backwards-compatibility old name 'buy_card_from_callingroup' is also usable. Call: /api/buy_card_from_callingroup
- Methods: POST, GET(if allowed, not recomended)
Parametres
- id - Calling Card Group ID in MOR database. Required.
- quantity - default 1. Optional.
- u - username for authentication. Required.
- email - email address, to send information about bought card Optional.
- hash - SHA1 hash constructed using id and quantity and API_Secret_Key ( More described in Constructing hash). Required.
Request
We have id = 6, quantity = 2, API Secret Key = 456789
We send:
HTML POST: http://<SERVER_IP>/billing/api/buy_card_from_callingroup?u=username&id=6&quantity=2&hash=37086d860581fabc278413cd1a417d5c079f6eba
NOTE that username are not included in hash
Returns
Success
<?xml version="1.0" encoding="UTF-8"?> <page> <cards> <card> <pin>...</pin> <number>..</number> <balance_without_vat>...</balance_without_vat> <currency>...</currency> </card> <card> <pin>...</pin> <number>...</number> <balance_without_vat>...</balance_without_vat> <currency>...</currency> </card> </cards> </page>
Errors
- <error>Bad login</error> - User supplied bad login or password.
- <error>Incorrect hash</error> - Hash was not correct. Check API_Secret_Key and order or params while concatenating hash_string.
- <error>Cardgroup was not found</error> - Use correct Calling Card Group ID .
- <error>Free cards was not found/error> - no free cards in Calling Card Group.