Declined payments on equipment (CCUT)

Use these steps to update credit card information for failed payments on equipment orders, and use the Credit Card Update Tool (CCUT).

Things to know

The customer's payment card isn't charged until the order is ready to ship.

  • Payment cards are validated when the device order is created.
  • Pre-orders and backorders are not charged when the order is placed.
.promocard .card--promo .cardPromo .card__content[data-guid="promocard-44e5bbcf71"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } @media (max-width: 767px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-44e5bbcf71"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-44e5bbcf71"] ol{ } } @media (min-width: 768px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-44e5bbcf71"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } .promocard .card--promo .cardPromo .card__content[data-guid="promocard-44e5bbcf71"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-44e5bbcf71"] ol{ }
[data-bg="promocard-44e5bbcf71-bg"] { --bg--size: cover; --bg--position: center; --bg--repeat: no-repeat; } @media (min-width: 768px){ [data-bg="promocard-44e5bbcf71-bg"] { --bg--position: center; } } @media (min-width: 1024px){ [data-bg="promocard-44e5bbcf71-bg"] { --bg--position: center; } }

When a payment card fails to process

  • The order is suspended for five (5) days. This gives the customer a chance to update the payment card information and keep their order priority.
  • Customers may receive an email or SMS notification.
    • Email: Dear Customer. Order #123 was not completed. Please call T-Mobile Customer service at 1-800-937-8997 to complete this transaction. Order number: #12345 Order date: XX/XX/XX. Sincerely, T-Mobile Customer Service
    • SMS: Payment for order #XYZ was declined; please call Customer Care to complete this transaction
  • The customer's order keeps its place and priority, based on the date and time the customer ordered initially. However, inventory is not held for unpaid orders; the system moves on to fulfill paid orders with available inventory.
.promocard .cmp-modal[data-guid="promocard-44e5bbcf71-modal"] { @media (min-width: 768px){ } }
.promocard .card--promo .cardPromo .card__content[data-guid="promocard-78d89bd7cb"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } @media (max-width: 767px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-78d89bd7cb"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-78d89bd7cb"] ol{ } } @media (min-width: 768px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-78d89bd7cb"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } .promocard .card--promo .cardPromo .card__content[data-guid="promocard-78d89bd7cb"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-78d89bd7cb"] ol{ }
[data-bg="promocard-78d89bd7cb-bg"] { --bg--size: cover; --bg--position: center; --bg--repeat: no-repeat; } @media (min-width: 768px){ [data-bg="promocard-78d89bd7cb-bg"] { --bg--position: center; } } @media (min-width: 1024px){ [data-bg="promocard-78d89bd7cb-bg"] { --bg--position: center; } }

If the suspended order is

  • Updated and successfully charged within five days:
    • The order goes back into queue and is prioritized based on the original order date and time.
    • The order was placed earlier than newer orders, so the customer doesn't have to wait for all other orders to complete before their order ships.
    • The estimated ship date updates based on this.
  • Updated within five days but fails to charge: The order is suspended again for 5 days from the failed payment. The customer can update the card again within this period.  
  • Not updated or fails to charge within five days: The order will be canceled.
.promocard .cmp-modal[data-guid="promocard-78d89bd7cb-modal"] { @media (min-width: 768px){ } }
.promocard .card--promo .cardPromo .card__content[data-guid="promocard-7a106f2022"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } @media (max-width: 767px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-7a106f2022"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-7a106f2022"] ol{ } } @media (min-width: 768px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-7a106f2022"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } .promocard .card--promo .cardPromo .card__content[data-guid="promocard-7a106f2022"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-7a106f2022"] ol{ }
[data-bg="promocard-7a106f2022-bg"] { --bg--size: cover; --bg--position: center; --bg--repeat: no-repeat; } @media (min-width: 768px){ [data-bg="promocard-7a106f2022-bg"] { --bg--position: center; } } @media (min-width: 1024px){ [data-bg="promocard-7a106f2022-bg"] { --bg--position: center; } }

Use the Credit Card Update Tool

 

Use the Credit Card Update Tool (CCUT) to investigate declined payment status and update payments. 

  • Order Status in Atlas may reflect a canceled status even though orders are still open.
  • Decline and chargeback reasons also apply to the tool.
  • Updating a credit card in AutoPay does not change the card used for device orders.
.promocard .cmp-modal[data-guid="promocard-7a106f2022-modal"] { @media (min-width: 768px){ } }
.promocard .card--promo .cardPromo .card__content[data-guid="promocard-73523ad66a"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } @media (max-width: 767px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-73523ad66a"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-73523ad66a"] ol{ } } @media (min-width: 768px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-73523ad66a"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } .promocard .card--promo .cardPromo .card__content[data-guid="promocard-73523ad66a"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-73523ad66a"] ol{ }
[data-bg="promocard-73523ad66a-bg"] { --bg--size: cover; --bg--position: center; --bg--repeat: no-repeat; } @media (min-width: 768px){ [data-bg="promocard-73523ad66a-bg"] { --bg--position: center; } } @media (min-width: 1024px){ [data-bg="promocard-73523ad66a-bg"] { --bg--position: center; } }

Restrictions

.promocard .cmp-modal[data-guid="promocard-73523ad66a-modal"] { @media (min-width: 768px){ } }

You cannot update the credit card info when the:

  • Charge has not yet been attempted.
  • Order has been canceled.
  • Order is in the process of being fulfilled.

Review and update payment method

  1. Use the Credit Card Update tool.
  2. Service Partners must access via Citrix or a browser window opened via Atlas.
  3. Enter the device order number in the Order Number field and select Search.
  4. Review the Payment Card Details on the Sales tab to view the most recent credit cards used for orders.
    Note: Credit card numbers displayed in the tool are encrypted and will not display as the same number entered during the order or update process.
  5. Review order information on the Sales tab to confirm you have the correct order.
  6. Review the Payment Card Declined status.
    • If Yes, continue to the next numbered step below.
    • If No, review the Status Description field, and check if it matches the statuses below:
      • For valid decline reasons listed on the Common credit and ATM/debit card decline reasons file, if the Description matches one of these, cancel the order and submit a new one for the customer.
      • For all other decline reasons (examples below), the customer must provide a different payment card to complete the order. 
      • CCUT decline reasons:
        • Cassandra Database Exception
        • Credit floor limit. Insufficient funds.
        • CNPAuth call failed
        • I/O error on POST request for "http://DA
        • Reason:java.lang.NullPointerException at
        • Invalid expirationMonthYear. Card is exp
        • updateAcquirerIndicator short-circuited
        • PaymentId is Required
        • Duplicate Request
        • RESPONSE PARSE ERROR:{"timestamp":"2020-
        • 413:Generic Unmapped partner denial code
        • Only approved payment can be processed
        • RESPONSE PARSE ERROR:400 Bad Request: Re
        • Call. Issuer wants voice contact with ac
        • Either commonCustomerID or customerId is:
  7. Identify the most recent credit card used by looking at the top row in the Payment Card Details section.
    • Refer customers to their credit card companies if they request the reason for their cards being declined.
    • Do not disclose CCUT decline reasons to customers.
  8. Select Add Payment Card in the Payment Card Details section.
  9. Enter the following credit card details from the new card in the Payment Card Details screen:
    • Card number
    • Card expiration (Use MMYYYY format. Example: October 2025 = 102025.)
    • Card CVV number
    • Cardholder name
  10. Select Validate Payment Card. If you receive a Please Enter Credit Card Type message, it means incorrect credit card data has been entered. Verify credit card information and retry.
  11. Select Update Payment Card.
    • This selection is only available after the card validation step has been completed.
    • When updating credit card on orders, the new credit card number will be encrypted after selecting Update Payment Card.
    • The new card numbers will be rearranged and appear as a different credit card number. This is normal.
    • Upon successful completion of the credit card change, the system will indicate the credit card has been updated in SAP Order Number.
    • If orders are locked due to multiple users accessing them at the same time, credit card updates will be deferred until the order is accessible.
    • In these situations, users see the following confirmation displayed:
      Credit card has been captured and order will be updated in the next 24 hours.
  12. Search for the order number again in the tool.
  13. Review the Order Status tab to confirm the order status.
  14. Advise customers their credit card info has been updated successfully. The card will be charged when inventory is assigned to the order, and the customer will receive a notification.
  15. Provide customer the Most Recent shipping date under Shipping Information. Do not provide the original estimated date as it is not updated when availability changes.

Tool access

The CCUT is available to Internal Care and Global Partner Care sites.

.promocard .card--promo .cardPromo .card__content[data-guid="promocard-23c70592ad"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } @media (max-width: 767px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-23c70592ad"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-23c70592ad"] ol{ } } @media (min-width: 768px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-23c70592ad"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } .promocard .card--promo .cardPromo .card__content[data-guid="promocard-23c70592ad"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-23c70592ad"] ol{ }
[data-bg="promocard-23c70592ad-bg"] { --bg--size: cover; --bg--position: center; --bg--repeat: no-repeat; } @media (min-width: 768px){ [data-bg="promocard-23c70592ad-bg"] { --bg--position: center; } } @media (min-width: 1024px){ [data-bg="promocard-23c70592ad-bg"] { --bg--position: center; } }

Internal Care

  1. To request tool access, file a service desk ticket.
  2. Account security must add the following permission to a user’s NT ID Profile: CC_Pmt_Process_users.
  3. If multiple users need access, submit all users on a single request.
.promocard .cmp-modal[data-guid="promocard-23c70592ad-modal"] { @media (min-width: 768px){ } }
.promocard .card--promo .cardPromo .card__content[data-guid="promocard-c86ce0b12d"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } @media (max-width: 767px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-c86ce0b12d"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-c86ce0b12d"] ol{ } } @media (min-width: 768px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-c86ce0b12d"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } .promocard .card--promo .cardPromo .card__content[data-guid="promocard-c86ce0b12d"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-c86ce0b12d"] ol{ }
[data-bg="promocard-c86ce0b12d-bg"] { --bg--size: cover; --bg--position: center; --bg--repeat: no-repeat; } @media (min-width: 768px){ [data-bg="promocard-c86ce0b12d-bg"] { --bg--position: center; } } @media (min-width: 1024px){ [data-bg="promocard-c86ce0b12d-bg"] { --bg--position: center; } }

Global Partner Care

 

To request tool access, follow the standard login request process in place for your site.

.promocard .cmp-modal[data-guid="promocard-c86ce0b12d-modal"] { @media (min-width: 768px){ } }
.promocard .card--promo .cardPromo .card__content[data-guid="promocard-4544c05a7c"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } @media (max-width: 767px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-4544c05a7c"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-4544c05a7c"] ol{ } } @media (min-width: 768px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-4544c05a7c"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } .promocard .card--promo .cardPromo .card__content[data-guid="promocard-4544c05a7c"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-4544c05a7c"] ol{ }
[data-bg="promocard-4544c05a7c-bg"] { --bg--size: cover; --bg--position: center; --bg--repeat: no-repeat; } @media (min-width: 768px){ [data-bg="promocard-4544c05a7c-bg"] { --bg--position: center; } } @media (min-width: 1024px){ [data-bg="promocard-4544c05a7c-bg"] { --bg--position: center; } }

Restore tool access that was lost

  1. Clear your browser cache and cookies. Use Internet Explorer for the best results.
  2. Confirm you are on the Sales Order Update tab when attempting to access the tool.
  3. Reboot your computer and attempt to access the tool again.
.promocard .cmp-modal[data-guid="promocard-4544c05a7c-modal"] { @media (min-width: 768px){ } }

Troubleshooting

  1. Confirm you are on the Sales Order Update link. Some profiles default to a different tab.
  2. Review Debit & credit card payments for possible root causes of the error.
  3. Find order and CCUT statuses listed in T-Mobile orders: Steps & status.
  4. Review the common error and resolution steps:
.promocard .card--promo .cardPromo .card__content[data-guid="promocard-80d549ed95"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } @media (max-width: 767px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-80d549ed95"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-80d549ed95"] ol{ } } @media (min-width: 768px){ .promocard .card--promo .cardPromo .card__content[data-guid="promocard-80d549ed95"] { --card--va: stretch; --card--ha: flex-start; --card--text-align: inherit; } .promocard .card--promo .cardPromo .card__content[data-guid="promocard-80d549ed95"] ul,.promocard .card--promo .cardPromo .card__content[data-guid="promocard-80d549ed95"] ol{ }
[data-bg="promocard-80d549ed95-bg"] { --bg--size: cover; --bg--position: center; --bg--repeat: no-repeat; } @media (min-width: 768px){ [data-bg="promocard-80d549ed95-bg"] { --bg--position: center; } } @media (min-width: 1024px){ [data-bg="promocard-80d549ed95-bg"] { --bg--position: center; } }

Issues

.promocard .cmp-modal[data-guid="promocard-80d549ed95-modal"] { @media (min-width: 768px){ } }
  • This message may appear when you load CCUT.
  • To fix it, click Sales Order Update to load the tool successfully.
  • This message may appear when you load CCUT.
  • To fix it, click Sales Order Update to load the tool successfully.
  • This message appears after selecting the Validate Payment button if incorrect credit card data has been entered.
  • Verify the credit card information, and try again.
  • Teams are working on changing the verbiage to a user-friendly message for the issue. Until then, you may encounter this error when trying to validate invalid credit card data that you have entered.
  • To report issues and errors after accessing the tool, call the Service Desk.
  • Keywords to note when calling are CCUT and Credit Card Update Tool.
  • Issues with the tool must be called in and cannot be filed through Compass or C2.