Other

doctorSIM Mobile Topups

by doctorSIM

Overview

doctorSIM Mobile Topups helps users browse supported countries, identify mobile carriers, compare mobile top-up prices, preview order totals, place confirmed orders, and check order status through ChatGPT. Regular users pay via a doctorsim.com payment link; PRO users can debit prepaid credits.

Tools

create_order

ChatGPT

Place the order after user confirmation (reuse price_token from preview_order). Guest default: returns payment_link + checkout_hash — no doctorSIM login required; share the link for payment on doctorsim.com. OAuth PRO: debits credits and returns order_id. Offer account linking only if the user asks for PRO credits or saved settings.

get_countries

ChatGPT

List countries available for top-up and gift card services.

get_operator_rates

ChatGPT

Get live pricing for an operator. Each rate has product_name, description (bundle/data details), and token for preview_order/create_order. Use operator_id from get_operator_service_types for the chosen type (bundle vs airtime vs data). Pass q to search descriptions (e.g. q="5GB whatsapp"). Rate totals are indicative — call preview_order for the authoritative breakdown before the user confirms.

get_operator_service_types

ChatGPT

After carrier lookup, list what recharge types are available for an operator: airtime (saldo), bundles, mobile data, etc. Each type has its own id_operator — use that id for get_operator_rates. Ask the user: "Do you want airtime, bundles, or data?" then call rates with the matching service type.

get_operators

ChatGPT

List mobile operators for a country (uses id_country from get_countries). Use when carrier lookup failed or the user already knows the operator.

get_order_status

ChatGPT

Check order or checkout status. Guest: pass checkout_hash from create_order (no login). OAuth: pass order_id from create_order or list_orders. Fulfilled gift cards may include redemption_code or redemption_url.

list_orders

ChatGPT

List completed or refunded orders for the authenticated user. Requires OAuth — not available for guest checkout.

lookup_carrier

ChatGPT

Identify the mobile carrier (operator) and country from a phone number in E.164 format (e.g. +522221231231). ALWAYS call this FIRST when the user provides a phone number for a top-up. Returns id_operator and id_country for the next steps. If lookup fails, ask the user which carrier/network the number uses.

preview_order

ChatGPT

Returns the price breakdown WITHOUT placing an order. Guest (no login): checkout_mode=payment_link — show amount_due_eur; user pays on doctorsim.com after create_order. OAuth PRO: checkout_mode=credits with credit applied. Ask whether the user wants a payment link (default) or to link a PRO account for credits. Call once after rate selection, then confirm before create_order.

search_products

ChatGPT

Browse the country catalog by operator/brand name (gift cards, gaming, etc.). For mobile top-ups with a phone number, use lookup_carrier first, then get_operator_service_types and get_operator_rates — NOT this tool alone. When operator_id AND q are both set, searches live rate descriptions (bundles/data) for that operator instead of catalog names. Paginated: pass cursor=meta.cursor when meta.has_more is true.

Links

Documentation ↗Privacy Policy ↗

App Stats

Tools

ChatGPT

Platforms