post https://accounts.xoxoday.com/chef/v1/oauth/api/
With the Get Mobile Top Up Catalog API, you can retrieve a curated list of available operators and the plans.
Filter Reference Table
| Key | Value Type | Description |
|---|---|---|
| productName | String | Product names to be included |
| country | String | Countries to be included |
| price | String | Price range filters to be included |
| minPrice | String | Maximum price of the products looked for |
| currencyCode | String | Currency codes to be included |
| deliveryType | String | Delivery type to the voucher (realtime or delayed) |
A limit of 500 requests per day is set for getVouchers API. If the number of requests cross the defined threshold you will receive the HTTP429 error.
Xoxoday recommends that you refresh your catalog four times within 24 hours.
The first sync happens at 12:00 AM followed by 6:00 AM, 12:00 PM, and 6:00 PM.
Please note - These timings are per GMT+5:30 (India) time zone
Xoxoday updates the exchange rate everyday at 03:01 AM (GMT+5:30)
Implementation Notes
- To fetch exchangeRate in the GetVouchersAPI, pass "exchangeRate": 1 in the request body
- To fetch the list of filters, use GetFiltersAPI
- To fetch the list of mobile top-up operators, pass "categoryType": "topup" in the GetVouchersAPI request body.
- To fetch the list of operators under a specific mobile top-up product, pass both "categoryType": "topup" and "parentProductId": "" in the request body — where is the ID received when fetching products with "categoryType": "topup".
- If the value type for a product is "open_value", please refer to the "minValue" and the "maxValue" parameters
- The values passed in the "fee" and "discount" parameters are in percentage (%)
- We recommend you cache the response from GetVouchersAPI in your database every time you sync our catalog