Express Order Submit
Version 1.0.2
Endpoint
POST
https://partner.att.com/omni-svcs/v1/carts/{cartId}/express-submit
Copy
Submits a fully-formed fiber order to AT&T's systems in a single call. The cartId is used to retrieve appointment data and terms data for technician installation. This endpoint accepts payment methods, enrollment preferences, terms acceptance, fulfillment options (for address changes), and installation appointment details. On success, returns immediate acknowledgment with the initial order status and customer order ID.
Express order submission request containing payment methods, enrollment preferences, terms acceptance, fulfillment options, and installation appointment details.
Path Parameters
- cartIdstringRequiredUnique identifier for the shopping cart. This cart ID is used to retrieve appointment data and terms data for technician installation.
Header Parameters
- appnamestringApplication name making the request
Body Parameters
- objectRequiredExpress order submission request payload containing all required order parameters including payment methods, enrollment preferences, terms acceptance, fulfillment options, and installation appointment details.
- paymentMethodsarray of objects
Array of payment methods for processing various payment types including AutoPay enrollment, one-time payments, and advance payments. Each payment method includes details such as card information, payment profile references, and consent agreements.
Container for payment method details including card information, payment profile, and consent agreements. - enrollmentobjectCustomer enrollment preferences for billing and payment options. Used for AutoPay and Paperless billing enrollments.
- oneTimePaymentobjectOne-time payment details referencing a payment method for immediate charges.
- termsobjectTerms and conditions acceptance keys that the customer has agreed to. These keys correspond to specific terms that may be required for order submission and fulfillment. Available terms include CSA, HTPT, EC, ABP & more.
- billingobjectCustomer enrollment preferences for billing and payment options. Used for AutoPay and Paperless billing enrollments.
- fulfillmentobjectSelected fulfillment options for product delivery. Used for address change scenarios. Available fulfillment options include DF (Direct Fulfillment), C2S (Click to Store).
- installationAppointmentobjectInstallation appointment details for technician installation including contact information and selected time slot.
Responses
Successful order submission response containing order ID, customer order ID, submission date, state, and order summary access token.
Body
application/json
- objectRequiredExpress order submission response containing order information, state, and access token. In case of conflicts (409), includes complete product order with validation details.
- idstringUnique identifier for the submitted order.
- statestringEnum: [acknowledged, rejected, pending, held, inProgress, cancelled, completed, failed, partial, assessingCancellation, pendingCancellation, Draft, Submitted]Possible values for the state of the order
- submissionDatestringDate and time when the order was submitted in ISO 8601 format.
- productOrderobjectA Product Order is a type of order which can be used to place an order between a customer and a service provider or between a service provider and a partner and vice versa,
- customerOrderIdstringCustomer-facing order identifier for tracking and reference purposes.
- orderSummaryAccessTokenstringAccess token for retrieving order summary details without authentication.
- errorobject