At TNZ, we provide tools that allow you to validate your integration and demonstrate its functionality without sending live messages or incurring costs.

This guide will walk you through simulating both successful and failed message deliveries for SMS, Voice, and Fax services.

 

Simulating a Failed Message

You can easily test how your application handles failed messages by sending to designated, non-existent numbers. This is a practical way to ensure your error handling and reporting mechanisms are working as expected.

The TNZ network will process the message as it normally would, identify that the number is invalid, and return a Failed status.

New Zealand Dummy Number

+6421000000

You may also use the +6425xxxxxxx range, however, beware the Numbering Allocation Deed (NAD) may allocate this range in future.

Australia Dummy Number

+61491570110

You may also use the Australian Communications and Media Authority's (ACMA) other creative-use numbers (full list).

Expected Outcome for a Failed Message

When you send a message to one of these test numbers, you will receive the following response:

  • Status: Failed

  • Result: Rejected-06-Invalid Mobile Number

  • Cost: $0.00

 

Simulating a Successful Message

For developers using our APIs, we offer a "Test Mode" that allows you to simulate a successful message submission without actually sending the message. 

Example API Request Snippet:

{
  "MessageData": {
    "Message": "This is a successful test message.",
    "Destinations": [
      {
        "Recipient": "+64212345678"
      }
    ],
    "Mode": "Test"
  }
}


The TNZ system will accept the message, bypass the actual sending process, and immediately return a Success status. This allows you to confirm that your API integration is correctly formatted and authenticated.

Expected Outcome for a Successful Test Message

  • Status: Success

  • Result: SendDisableSuccess [may be overwritten if a more accurate Result is known]

  • Cost: $0.00

 

Cross-Platform Testing

The testing methods described in this article, for both failed and successful messages, can be utilized across our different messaging products. You can use the provided dummy numbers and the API test mode for:

  • SMS

  • Voice (including Text-to-Speech)

  • Fax