MVNX API

The Wireless Promotion Eligibility API allows external partners to seamlessly integrate AT&T wireless promotion checks into their digital sales and service journeys. It is designed for scenarios where a customer interacts with your system—via APIs—to:

• Add a new line
• Activate a new service
• Upgrade an existing device

A key part of these workflows is the customer’s option to trade in a device to receive promotional credits. This API provides the real‑time evaluation needed to determine eligibility for such trade‑in promotions.

AT&T’s Wireless Promotion Eligibility API exposes secure endpoints that enable approved partners to identify which promotions a customer, account, or device qualifies for. By integrating these endpoints, your application can present accurate, up‑to‑date promotional offers at the point of sale, reducing manual effort and minimizing errors in promotion application.

FLOW | Wireless | Inquire Trade-in Device & Fetch Trade-in Promotion

Core Capabilities

1. Retrieval of Available Offers

Obtain trade‑in device details along with the questionnaire you will present in your UI.

2. Real‑Time Promotion Eligibility Checks

Determine the trade‑in promotional value a customer is eligible for during the sales journey, including:

• Validating eligibility for targeted campaigns during checkout
• Confirming whether a proposed trade‑in qualifies for promotional credits

Typical Integration Flow

1. Customer Action
   The customer initiates an action—such as adding a line, opening a new account, or upgrading a device—and optionally indicates they want to trade in a device.
2. Eligibility Check
   Your system calls the Wireless Trade‑In Device API to retrieve the trade‑in questionnaire and device details.
3. Promotion Retrieval
   The API returns eligible promotions and the trade‑in value for the device. Your application presents these options in the UI.
4. Completion
   After the customer selects an offer, your system finalizes the order or enrollment and applies the approved promotional benefits.

Getting Started

To integrate the Wireless Promotion Eligibility API into your systems, follow the steps below.

1. Obtain API Access

Request API credentials from AT&T through your established partner or onboarding channel.
As part of this process, you may be required to:

• Complete registration and onboarding steps
• Agree to applicable terms of use and security requirements
• Provide technical contact information

2. Review Documentation

Consult the official API documentation for:

• Endpoint catalog and environment URLs (sandbox and production)
• Authentication and authorization model
• Request/response formats (e.g., JSON schema)
• Required parameters for key use cases (account, device, promotion, trade‑in)
• Sample requests and responses

This will help you design your integration correctly from the outset.

3. Implement Authentication

Implement secure authentication for all API calls.
Commonly this includes:

• OAuth 2.0 client credentials or another approved mechanism
• Secure storage and rotation of credentials
• Use of TLS/HTTPS for all requests

Ensure that your implementation follows your organization’s security guidelines as well as AT&T’s requirements.

4. Integrate Endpoints

Begin integrating the endpoints into your workflows by:

• Making test calls in a sandbox or non‑production environment
• Mapping your internal identifiers (accounts, devices, offers) to those expected by the API
• Implementing logic to handle multiple eligible offers and user selection
• Adding robust error and timeout handling to protect the user experience

Use the test environment to validate:

• Eligibility checks for different customer and device scenarios
• Offer retrieval for a variety of account types and promotions
• Promotion validation during mock transactions

5. Go Live

Once your integration passes functional, performance, and security testing:

• Request promotion to production credentials and endpoints (if separate from sandbox)
• Validate configuration in production with controlled test scenarios
• Monitor logs and metrics closely after launch to identify any integration issues

After go‑live, maintain alignment with ongoing changes by:

• Monitoring release notes and deprecation notices in the API documentation
• Updating your integration as new promotions, parameters, or response attributes are introduced

Next Steps

If your organization is ready to integrate:

• Ensure you have or request the appropriate partner access and credentials.
• Obtain the full Wireless Promotion Eligibility API documentation from your AT&T integration contact or developer portal.
• Begin designing your eligibility and offer workflows around the capabilities described above.

By integrating the Wireless Promotion Eligibility API, you can provide customers and agents with accurate, real-time promotion information, streamline trade‑in and upgrade flows, and help ensure that promotions are applied correctly at the point of sale.