# DT One Developers Documentation

> DT One Developer Docs is the go-to resource for businesses and developers looking to integrate global digital value services such as mobile top-ups, data bundles, gift cards, and digital wallets into their platforms. Our comprehensive API documentation and integration guides help partners connect seamlessly with DT One’s global network, offering real-time transaction experience

## Guides
- [About DT One Platform](https://developers.dtone.com/docs/about-dt-one-products-and-services.md)
- [About Products](https://developers.dtone.com/docs/about-products-copy.md): A Product is a unit of digital value delivered to an end user through the DT One Digital Value Services network.
- [Product Type](https://developers.dtone.com/docs/product-type.md): A Product Type defines the delivery mechanism of a product and determines how the digital value is provided to the receiver.
- [Identifiers and Required Fields](https://developers.dtone.com/docs/identifiers-and-required-fields.md): A Product communicates its required parameters through specific identifier fields. These dictate the data needed for a transaction.
- [Product Metadata](https://developers.dtone.com/docs/product-metadata.md): Metadata provides descriptive information about a product but does not impact how it is processed or displayed.
- [Product and Pricing Updates](https://developers.dtone.com/docs/product-and-pricing-updates.md): DT One sends regular e-mails about Product and Pricing Updates but does not offer API webhooks.
- [Product Discovery](https://developers.dtone.com/docs/product-discovery.md): Browse and filter available products, design the user interface for purchase flows, and define how products are delivered to end users.
- [Endpoints for Product Discovery](https://developers.dtone.com/docs/endpoints-for-product-discovery.md): Structured results of API calls help users quickly find relevant products.
- [Required Parameters for Building UI](https://developers.dtone.com/docs/required-parameters.md): Your user interface needs to dynamically adjust to reflect required fields based on the product’s configuration.
- [Handling Transactions](https://developers.dtone.com/docs/handling-transactions.md): Transactions follow a structured process, undergoing multiple status changes before reaching a final state. A successful transaction results in a charge to the initiator's wallet, reflecting the wholesale price of the product.
- [Information Security](https://developers.dtone.com/docs/information-security.md)
- [Choose a Solution](https://developers.dtone.com/docs/choose-a-solution.md): Base your choice on **technical capabilities**, **time-to-market goals**, **operational needs**, and the **level of customization**.
- [Create an Account](https://developers.dtone.com/docs/create-an-account.md): Whatever solution you choose, we recommend that you quickly create at least one account in DT Shop. As soon as you sign up, you get an account currency and are provided with a price list. If  you are happy with default settings, you can fund your wallet and start transacting. Support is always available to change your default settings or help you with UI SDK or API setup.
- [Security](https://developers.dtone.com/docs/1-implement-whitelists-in-dt-one.md): Whitelisting refers to the practice of explicitly allowing access only from a predefined list of trusted entities. These entities can be IP addresses, domains, or even specific API keys.
- [More Information](https://developers.dtone.com/docs/introduction-to-the-dvs-api-copy.md): Access help and support.
- [Optimize Product Discovery](https://developers.dtone.com/docs/optimize-product-discovery.md)
- [Learn about Products, Services, and Subservices](https://developers.dtone.com/docs/learn-about-products-services-and-subservices.md): Before you start to optimize product discovery, you need to grasp what Products, Services, and Subservices are.
- [Synchronize Product Catalogs](https://developers.dtone.com/docs/syncronize-product-catalogs.md): To optimize your organization's access to product information, we suggest establishing a local product catalog. Storing the catalog in a local cache or database can improve retrieval speed.
- [Look Up Mobile Numbers](https://developers.dtone.com/docs/look-up-mobile-numbers.md): The Lookup endpoint simplifies the discovery of mobile products by mapping mobile numbers to their respective operators. This helps minimize failed transactions and improve the user experience.
- [Best Practices for Filtering and Categorizing Products](https://developers.dtone.com/docs/best-practices-for-filtering-and-categorizing-products.md): You can filter products using several available criteria to help categorize them effectively.
- [Get Operator Logos](https://developers.dtone.com/docs/integrate-operator-logos.md): The DT One Digital Value Services API allows you to enhance your application by displaying operator logos, providing a more informative user experience.
- [Integrate Mobile Products](https://developers.dtone.com/docs/directly-charge-with-mobile-number.md): The `Mobile (1)` service enables users to top up mobile accounts. Fixed value topups are available for Airtime, Data, and Bundles. Ranged value topups are available for Airtime.
- [Mobile: FIXED_VALUE_RECHARGE](https://developers.dtone.com/docs/airtime-fixed-copy.md): Top up a receiver's account with a <Glossary>fixed value</Glossary>.
- [Mobile: RANGED_VALUE_RECHARGE](https://developers.dtone.com/docs/new-mobile-template.md): Recharge a receiver's account within a range of values.
- [Mobile: FIXED_VALUE_PIN_PURCHASE](https://developers.dtone.com/docs/mobile-ranged_value_recharge-copy.md): Send the user a PIN or voucher code for redemption at a later time.
- [Integrate eSIM Services](https://developers.dtone.com/docs/esim-1.md)
- [eSIM: Purchase a New eSIM](https://developers.dtone.com/docs/esim-fixed_value_pin_purchase.md)
- [eSIM: Top-Up an Existing eSIM](https://developers.dtone.com/docs/esim-topup.md)
- [Webhooks](https://developers.dtone.com/docs/webhooks.md): Receive real-time event notifications from DT One at an HTTPS endpoint you control.
- [Webhook event reference](https://developers.dtone.com/docs/webhook-events.md): The supported webhook types and the exact data payload of each.
- [Integrate Gift Cards and Vouchers](https://developers.dtone.com/docs/gift-cards-and-vouchers.md)
- [Gift Card: FIXED_VALUE_RECHARGE](https://developers.dtone.com/docs/gift-card-fixed_value_recharge.md): Top up a receiver's account with a <Glossary>fixed value</Glossary>.
- [Gift Card: RANGED_VALUE_RECHARGE](https://developers.dtone.com/docs/gift-card-ranged_value_recharge.md): Recharge a receiver's account within a range of values.
- [Gift Card: FIXED_VALUE_PIN_PURCHASE](https://developers.dtone.com/docs/gift-card-fixed_value_pin_purchase.md): Send the user a PIN or voucher code for redemption at a later time.
- [Requests Per Second (RPS) Allocation](https://developers.dtone.com/docs/requests-per-second-rps.md): At DT One, we use **Requests Per Second (RPS)** to measure the throughput of your Digital Value Services (DVS) API usage. This metric helps us ensure optimal performance and stability for all our customers.
- [About Low Code](https://developers.dtone.com/docs/undestand-the-low-code-solution-ui-sdk.md): Enable digital sales quickly with our ready-to-use Low-Code solution. By using pre-built flows, you can skip complex coding and retain full checkout and payment control.
- [Get Required Credentials](https://developers.dtone.com/docs/obtain-dt-one-authentication-credentials.md): Before integrating with DT One's low-code solution, you must obtain API credentials and a Client ID. Credentials are required for secure backend integration and SDK instance identification
- [Choose a Usage Mode](https://developers.dtone.com/docs/ui-sdk-modes.md): Your choice of a Usage Mode for the Low Code Solution depends on customization needs, how much you want to control the user flow, and the amount of technical effort you can afford.
- [Available Usage Modes](https://developers.dtone.com/docs/available-usage-modes.md)
- [Best Fit for Businesses](https://developers.dtone.com/docs/best-fit-for-businesses.md)
- [How Each Usage Mode Works](https://developers.dtone.com/docs/how-each-usage-mode-works.md)
- [Key Advantages](https://developers.dtone.com/docs/key-advantages.md)
- [Things to Consider](https://developers.dtone.com/docs/things-to-consider.md)
- [Choose the Right Mode](https://developers.dtone.com/docs/choose-the-right-mode.md)
- [UI SDK](https://developers.dtone.com/docs/ui-sdk.md)
- [Set up UI SDK](https://developers.dtone.com/docs/verify-your-development-environment-for-dt-one-ui-sdk-integration.md): The UI SDK is a script that runs directly inside a website or web-based application.
- [Checklist](https://developers.dtone.com/docs/checklist.md): Ensure you have the tools and information you need to get started.
- [Test UI SDK in Browser](https://developers.dtone.com/docs/test-ui-sdk-in-browser.md)
- [Select Environment and Version](https://developers.dtone.com/docs/select-environment-and-version.md): Set up the correct version of your enviornment for Production or for Preproduction
- [Style the Screen Area](https://developers.dtone.com/docs/style-the-screen-area.md): Define the visual appearance of the SDK container element using CSS.
- [Embed the SDK in the HTML Page](https://developers.dtone.com/docs/embed-the-sdk-in-the-html-page.md): Embed the SDK in the HTML
- [Set Content Security Policy (CSP)](https://developers.dtone.com/docs/set-content-security-policy-csp.md): Configure your Content Security Policy (CSP) to allow access to resources like scripts, styles, images, and connections from the `dtone.com` domain and its subdomains.
- [Initialize UI SDK](https://developers.dtone.com/docs/initialize.md): End users can only select products and check them out after the solution is initialized.
- [Initialization Methods](https://developers.dtone.com/docs/initialization-methods.md)
- [Initialization Flows](https://developers.dtone.com/docs/initialization-flow.md)
- [Collect Payment](https://developers.dtone.com/docs/collect-payment.md): The initialization step has enabled the user to select and check out a product in the browser.  You now need to collect the payment from the user.
- [Finalise](https://developers.dtone.com/docs/finalise.md): Finialisation involves making API calls, displaying the transaction status, and responding to HTTP callbacks.
- [Transaction Object](https://developers.dtone.com/docs/transaction-object.md): A JSON object that encapsulates essential transaction data that can be used for purposes such as displaying order information, payment processing, and database record storage.
- [Configure Solution Behavior (sdkConfiguration File)](https://developers.dtone.com/docs/configure-solution-behavior.md): An `sdkConfiguration` object that you create serves as the central hub for all your SDK settings.
- [Use DT Shop](https://developers.dtone.com/docs/dt-shop.md): Use this business-to-business self service platform to efficiently manage digital transactions, finances, analytics, and integrations - all without requiring development effort.  Not a single line of code is needed!
- [Create and activate your DT Shop account](https://developers.dtone.com/docs/onboarding-and-sign-in.md)
- [Sign In](https://developers.dtone.com/docs/sign-in.md)
- [Reset Two factor Authentication](https://developers.dtone.com/docs/reset-two-factor-authentication.md)
- [Restore Access (Forgot Password)](https://developers.dtone.com/docs/restore-access-forgot-password.md)
- [Managing Users & Roles](https://developers.dtone.com/docs/managing-users.md)
- [Create and Manage Roles](https://developers.dtone.com/docs/create-and-manage-roles.md)
- [User Management: Inviting & Managing Access](https://developers.dtone.com/docs/inviting-users.md)
- [Posting Single Transactions](https://developers.dtone.com/docs/posting-single-transactions.md)
- [Transactions Search](https://developers.dtone.com/docs/transactions-search.md)
- [Send Promotional Top Up](https://developers.dtone.com/docs/send-promotional-top-up.md)
- [NEW! Purchase eSIM](https://developers.dtone.com/docs/new-purchase-esim.md)
- [Initiate Utilities Bill Payment](https://developers.dtone.com/docs/initiate-utilities-bill-payment.md)
- [NEW! Purchase Global and Regional Gift Card](https://developers.dtone.com/docs/new-purchase-global-and-regional-gift-card.md)
- [New! Purchase SSS Contribution Product](https://developers.dtone.com/docs/new-purchase-sss-contribution-product.md)
- [Managing Finance](https://developers.dtone.com/docs/managing-finance.md)
- [Replenish wallet with bank transfer](https://developers.dtone.com/docs/replenish-wallet-with-bank-transfer.md)
- [Proforma Invoice](https://developers.dtone.com/docs/proforma-invoice.md)
- [Replenish wallet with PayPal](https://developers.dtone.com/docs/instant-payment.md)
- [Replenish with credit card](https://developers.dtone.com/docs/replenish-with-credit-card.md)
- [Replenish wallet with SEPA](https://developers.dtone.com/docs/replenish-wallet-with-sepa.md)
- [Replenish DT Shop Wallet with Alipay](https://developers.dtone.com/docs/replenish-dt-shop-wallet-with-alipay.md)
- [Replenish DT Shop Wallet with GrabPay](https://developers.dtone.com/docs/replenish-dt-shop-wallet-with-grabpay.md)
- [How to Manage Retail Prices](https://developers.dtone.com/docs/how-to-manage-retail-prices.md)
- [New! How to Set Rounded Retail Prices in DT Shop](https://developers.dtone.com/docs/new-how-to-set-rounded-retail-prices-in-dt-shop.md)
- [How to Generate Pricelist](https://developers.dtone.com/docs/how-to-generate-pricelist.md)
- [How to Deactivate / Activate Products](https://developers.dtone.com/docs/how-to-deactivate-activate-products.md)
- [NEW! How to Subscribe to Pricelist Change Notifications (Pricelist Alerts)](https://developers.dtone.com/docs/new-how-to-subscribe-to-pricelist-change-notifications-pricelist-alerts.md)
- [How to use Reporting Tool](https://developers.dtone.com/docs/how-to-use-reporting-tool.md)
- [Transaction Summary Report](https://developers.dtone.com/docs/transaction-summary-report.md)
- [Transaction Detail Report](https://developers.dtone.com/docs/transaction-detail-report.md)
- [Account Statement](https://developers.dtone.com/docs/account-statement.md)
- [How to Schedule Reports](https://developers.dtone.com/docs/how-to-schedule-reports.md)
- [How to generate API Keys, whitelist IP addresses and set callback credentials](https://developers.dtone.com/docs/how-to-generate-api-keys-whiteist-ip-addresses-and-set-callback-credentials.md)
- [Preproduction Environment](https://developers.dtone.com/docs/preproduction-environment.md)
- [How to Update Your Address Details](https://developers.dtone.com/docs/how-to-update-your-address-details.md)
- [Branding (White-Labelling DT Shop)](https://developers.dtone.com/docs/branding.md)
- [About the Rewards Portal](https://developers.dtone.com/docs/dt-shop-1.md): The DT One rewards portal provides your organization with a powerful and seamless way to distribute digital rewards, such as mobile top-ups, gift cards, and vouchers, all within a branded online environment.

## API Reference
- [Overview](https://developers.dtone.com/reference/overview.md): This API serves as the primary gateway for digital value transactions across the extensive [DT One](https://www.dtone.com) network.
- [Sandbox](https://developers.dtone.com/reference/sandbox.md): A dedicated sandbox environment facilitates seamless integration and testing.
- [Versioning](https://developers.dtone.com/reference/versioning.md): Endpoints of the API are prefixed with a corresponding version number.
- [Transactions](https://developers.dtone.com/reference/transactions-1.md)
- [Balances](https://developers.dtone.com/reference/balances-1.md): This endpoint can be used to retrieve the status of all your balances in real time.  Note that transactions will only be accepted if you have enough funds on your account so it's important to keep an eye on it.
- [Flow](https://developers.dtone.com/reference/modes.md): After selecting a product through API discovery, transactions can be processed in either synchronous or asynchronous mode
- [Callbacks](https://developers.dtone.com/reference/callbacks.md): Real-time transaction status updates are sent to a provided callback URL during processing
- [Status and Errors](https://developers.dtone.com/reference/status-and-errors.md)
- [Pagination](https://developers.dtone.com/reference/pagination.md): API resources supporting bulk fetches via "list" API methods will be returned in a paginated fashion.
- [Services](https://developers.dtone.com/reference/services-and-subservices.md): The Digital Value Services platform offers various products across diverse industries, categorized as "services." Each service encompasses specific examples to cater to different needs.
- [Internationalization](https://developers.dtone.com/reference/internationalization.md): Support for adapting content to different languages and regions (internationalization) is implemented through standard HTTP content negotiation.
- [Rate Limiting](https://developers.dtone.com/reference/rate-limiting.md): API endpoints enforce rate limiting to protect the service from excessive requests.
- [Authentication](https://developers.dtone.com/reference/authentication-1.md)
- [Retrieve list of services](https://developers.dtone.com/reference/getservices.md)
- [Retrieve service by ID](https://developers.dtone.com/reference/getservicebyid.md)
- [Retrieve list of active campaigns](https://developers.dtone.com/reference/getcampaigns.md)
- [Retrieve campaign by ID](https://developers.dtone.com/reference/getcampaignbyid.md)
- [Retrieve list of promotions](https://developers.dtone.com/reference/getpromotions.md)
- [Retrieve promotion by ID](https://developers.dtone.com/reference/getpromotionbyid.md)
- [Retrieve list of benefit types](https://developers.dtone.com/reference/getbenefittypes.md)
- [Retrieve list of operators](https://developers.dtone.com/reference/getoperators.md)
- [Retrieve operator by ID](https://developers.dtone.com/reference/getoperatorbyid.md)
- [Retrieve list of countries](https://developers.dtone.com/reference/getcountries.md)
- [Retrieve country by ISO code](https://developers.dtone.com/reference/getcountrybyisocode.md)
- [Retrieve list of products](https://developers.dtone.com/reference/getproducts.md): Retrieve a paginated list of products with optional filtering and sorting.  **Available sort fields:** - `id`: Product ID - `name`: Product name   - `amount`: Destination Amount
- [Retrieve product by ID](https://developers.dtone.com/reference/getproductbyid.md)
- [Balances](https://developers.dtone.com/reference/balances.md): Real-time balance retrieval is available via this endpoint. Account funds must be sufficient for transaction processing; therefore, balance monitoring is essential.
- [Retrieve balances](https://developers.dtone.com/reference/getbalances.md)
- [Create a transaction asynchronously](https://developers.dtone.com/reference/posttransactionasync.md): Two transaction modes (asynchronous and synchronous) are available. This endpoint lets you create a transaction in the **asynchronous** mode. Note that the `auto_confirm` flag can be set to simultaneously create and confirm a transaction in one step (i.e. HTTP request).
- [Create a transaction synchronously](https://developers.dtone.com/reference/posttransactionsync.md): Two transaction modes (asynchronous and synchronous) are available. This endpoint lets you create a transaction in the **synchronous** mode. Note that the `auto_confirm` flag can be set to simultaneously create and confirm a transaction in one step (i.e. HTTP request).
- [Query a transaction by ID](https://developers.dtone.com/reference/gettransactionbyid.md): This endpoint will return the details of the requested transaction.
- [Query list of transactions](https://developers.dtone.com/reference/gettransactions.md): This endpoint will return a list of transactions matching the search criteria. Please note that when this endpoint is called without any parameters and/or if neither date ranges (i.e. `from_date`, `to_date`) nor `external_id` are specified, transactions created within the last 24 hours will be returned by default.
- [Confirm a transaction asynchronously](https://developers.dtone.com/reference/posttransactionconfirmasync.md): If an **asynchronous** transaction was created without setting the `auto_confirm` flag, this endpoint will have to be called to confirm the transaction. Once successfully confirmed, the transfer order will be submitted to the operator to be processed.  Please note that only unexpired transactions can be confirmed, as denoted in the `confirmation_expiration_date` field of the transaction. Beyond this, the only allowed change is to [cancel the transaction](/#tag/Transactions/paths/~1transactions~1{transaction_id}~1cancel/post), so as to release the held balance.
- [Confirm a transaction synchronously](https://developers.dtone.com/reference/posttransactionconfirmsync.md): If a **synchronous** transaction was created without setting the `auto_confirm` flag, this endpoint will have to be called to confirm the transaction. Once successfully confirmed, the transfer order will be submitted to the operator to be processed.  Please note that only unexpired transactions can be confirmed, as denoted in the `confirmation_expiration_date` field of the transaction. Beyond this, the only allowed change is to [cancel the transaction](/#tag/Transactions/paths/~1transactions~1{transaction_id}~1cancel/post), so as to release the held balance.
- [Cancel a transaction](https://developers.dtone.com/reference/posttransactioncancel.md): If a transaction is still in the `CREATED` state, it has not yet been submitted to the receiving operator for processing. You can thus request to cancel such transactions by calling this endpoint.
- [Look up operators for a given mobile number](https://developers.dtone.com/reference/postlookupmobilenumber.md)
- [Look up operators for a given mobile number](https://developers.dtone.com/reference/getlookupmobilenumber.md)
- [Inquire statements for a given account number](https://developers.dtone.com/reference/postlookupstatementinquiry.md)
- [Retrieve remaining product benefits for a given credit party](https://developers.dtone.com/reference/postlookupcreditpartybenefits.md)
- [Retrieve status for a given credit party](https://developers.dtone.com/reference/postlookupcreditpartystatus.md)

## Changelog
- [[1.22.1] 2026-02-13](https://developers.dtone.com/changelog/1221-2026-02-13.md)
- [[1.22.0] 2025-10-29](https://developers.dtone.com/changelog/1220-2025-10-29.md)
- [[1.21.0] 2024-07-22](https://developers.dtone.com/changelog/1210-2024-07-22-1.md)
- [[1.20.0] 2024-07-01](https://developers.dtone.com/changelog/1200-2024-07-01.md)
- [[1.19.0] 2024-05-21](https://developers.dtone.com/changelog/1190-2024-05-21.md)
- [[1.18.0] 2024-05-13](https://developers.dtone.com/changelog/1180-2024-05-13.md)
- [[1.17.0] 2024-01-02](https://developers.dtone.com/changelog/1170-2024-01-02.md)
- [[1.16.0] 2023-09-25](https://developers.dtone.com/changelog/1160-2023-09-25.md)
- [[1.15.0] 2023-08-14](https://developers.dtone.com/changelog/1150-2023-08-14.md)
- [[1.14.6] 2023-08-04](https://developers.dtone.com/changelog/1146-2023-08-04.md)