API Blog

Communication and Data Quality APIs for real-time business solutions.

Archive for the ‘CDYNE News’ Category


CDYNE Launches International Address Verification

Posted by: CDYNE  /  Tags: , , , , , , , , , , , , , ,

International-address-verification

Today CDYNE launched PAV-I, an international postal address verification API which validates addresses for over 240 countries. Businesses with an international market presence can ensure data quality for their customer base without any prior knowledge of international address formats or foreign characters. One of the great features of PAV-I is that it takes the guesswork out of the many address formats that exist worldwide. We are excited about this new offering because it complements CDYNE’s existing PAV API, which is CASS Certified™ for US postal addresses, and now verifies Canadian addresses at no additional cost.

TRANSLITERATE ADDRESSES FROM ONE ALPHABET TO ANOTHER

PAV-I supports 9 writing systems and will transliterate address data for Latin, Cyrillic, Greek, Hebrew, Japanese Kanji, Chinese, Arabic, Thai, and Korean Hangul. For example, if you input a Japanese address in English characters, you have the option to request the validated address in either English or Japanese Kanji.

We will use the address 3-24-20, YOKODAI ISOGO-KU YOKOHAMA, 2350045, JAPAN to highlight the transliteration capabilities of PAV-I. The default setting for transliteration is false. When set to true, the verified address will output to the native language if it is supported. The only exception to this is the country output field, which will return in English.

Address entered with native output set to true:

Input Address: 3-24-20 YOKODAI ISOGO-KU YOKOHAMA 2350045 JAPAN

Output Results: A RESCODE of “1″ and OUTPUTSTATUS of “C” combined means the address was successfully matched or parsed and has been corrected to match the reference data. The corrected and transliterated address is output both in the ADDR field as well as the individual address fields. As mentioned earlier, the COUNTRY output field will return in English and does not transliterate.

 

The last output field MATCHLVL returned a “2,” which signifies verification down to the street level. These output returns are meaningful because they provide a record of any corrections that were made to your addresses along with the level to which the addresses were verified. The following MATCHLVL returns are available:

  • 0 – No Match
  • 1 – Town, City, Locality, Municipality, Suburb
  • 2 – Street
  • 3 – Premise (Building)
  • 4 – Organisation (Varies by country, Business or Administrative Entity)

 

Address entered with native output set to false:

Input Address: 3-24-20 YOKODAI ISOGO-KU YOKOHAMA 2350045 JAPAN

Output Results: A RESCODE of “1″ and OUTPUTSTATUS of “C” combined means the address was successfully matched or parsed and has been corrected to match the reference data.

INNOVATIVE PARSING ABILITY

PAV-I has the ability to parse addresses entered in one or many fields. Using multiple address fields for input is useful when you are familiar with international addresses and the specific elements of the input address. If uncertain of the specific address elements, inputting information in the wrong fields may complicate or confuse matching.

To illustrate this, let’s use the address Rose House, 51-59 Circular Road, Isle of Man, IM1 1AZ, United Kingdom to show how this address can be entered using fielded or unfielded input.

Address entered with unfielded input:

Input Address: Rose House, 51-59 Circular Road, Isle of Man, IM1 1AZ, United Kingdom

Output Results: A RESCODE of “1″ and OUTPUTSTATUS of “V” combined means the address was successfully matched or parsed and has been verified mailable with no change.

Address entered with fielded input:

Input Address: Rose House, 51-59 Circular Road, IM1 1AZ, United Kingdom

Output Results: In this case, “Isle of Man” was not included in the input data. As a result, RESCODE  “1″ and OUTPUTSTATUS “C” was returned (the address was successfully matched or parsed and has been corrected to match the reference data).

PAV-I VERIFICATION CODES

Addresses are verified with a RESCODE and an OUTPUTSTATUS. The RESCODE returns data based on whether the address was successfully matched or not. The OUTPUTSTATUS provides extra details regarding the verification or correction that occurred when verifying the address. 

RESCODE
OUTPUT STATUS DETAILS
0   Internal Error Occurred (Contact CDYNE)
1 V Address was successfully matched or parsed and has been verified mailable with no change
1 C Address was successfully matched or parsed and has been corrected to match reference data.
1 P Address was successfully parsed but there is no matching reference data.
2 N There were no hits found and address was not matched or parsed. (This is also returned if an attempt is made to verify an unsupported country.)
3 P Insufficient input details (Too many possible matches)
4   Ambiguous result (Many possible address results)

 

For more information about CDYNE PAV-I API, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.

Or sign up for a free trial license key to test CDYNE PAV-I API.

Developers find CDYNE PAV-I API integration details on the CDYNE developer’s wiki

 

CDYNE PAV Now Offers Full Canadian Address Verification

Posted by: CDYNE  /  Tags: , , , , , , , , , , , , ,

Canadian Address Verification

CDYNE’s Postal Address Verification API now fully validates Canadian addresses. You can standardize, correct, and verify US and Canadian addresses in one step. The API has been renamed PAV, and is the perfect complement to the PAV-I API, which standardizes and validates international addresses.

There are two supported operations for Canadian address verification: VerifyAddress and VerifyAddressAdvanced. Only two return codes apply to Canadian addresses. A return code of 200 means that the address was verified. A return code of 202 means that the input address is confirmed for all components except for the secondary number. A return code of 10 means that the address could not be found or verified.

If you have Canadian addresses with missing zip codes, PAV can append the zip code of the address as long as the Canadian province name has been abbreviated at input. Please see image below for an example.

We will use the address 75 University Ave West, Waterloo, ON to emphasize PAV’s ability to append a missing zip code.

Address input with missing zip code:

Address output with appended zip code:

 

As you can see, the correct zip code has been added and the address yields a return code of 200, meaning that the address is verified.  The address is now prepared for optimum delivery as suggested by the Canada Post with the output address properly parsed in upper case fonts and the zip code separated after the first three characters.

For more information about CDYNE PAV, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.

Or sign up for a free trial license key to test CDYNE PAV.

Developers find CDYNE PAV API integration details on the CDYNE developer’s wiki.

View Reseller License Key Usage on Your CDYNE Web Service Invoice

Posted by: CDYNE

reseller-invoice

Many customers activate more than one license key per Web Service through CDYNE’s free Reseller Web Service. This service allows you to add, enable, disable, and get transaction counts via a Web Service. You only pay one monthly fee regardless of the number of license keys generated.

At the time of invoicing, Reseller Web Service customers have three ways to view their account usage and totals. The first view is the main invoice which includes the Web Service monthly fee as well as the total monthly transaction fee per Web Service. Here is an example invoice showing a total of 96 SMS transactions:

So how do you find the transaction and price breakdown of each reseller license key? At the bottom of the invoice there is a statement, “For a detailed report:” with a link that follows. Clicking on this link will open up a separate page with two additional reports:  the CDYNE Corporation billing detail report, and a Breakdown of Summary Items report.

The CDYNE Corporation billing detail report shows a list of each license key under the parent account. It also shows the transactions per key, as well as the total transaction charge per key. Below is an example that shows five license keys for SMS Notify! The first license key ending in “3abc4d” had 25 transactions for a total of 25 cents.

The Breakdown of Summary Items report shows a daily summary of transactions processed per license key. Continuing with the license key ending in “3abc4d,” the report below shows the daily count – starting with 3 transactions on 10/31, and ending with 2 transactions on 11/26.

For more account information, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.

CDYNE Phone Notify! Account Reporting Features

Posted by: CDYNE  /  Tags: , , , , , , , , , , , ,

phonereports

CDYNE Corporation offers helpful account reporting features for Phone Notify! API, a two way voice API that sends and receives text to speech phone messages. Reporting features include the date, number of calls, answered status, whether or not voicmail or a fax picked up, as well as transfers. All reports can be exported to an .xls or.csv file. It is simple to access the reports by following these steps.

1. Log into your account online at http://www.cdyne.com/ in the upper-right hand corner.

2. Once logged in, select “Manage Services” on the left-hand gray menu.

3. After selecting Manage Services, you will navigate to a page listing your active and inactive Web Services. Active Web Services will be listed on the top of the page.

4. Select an active service to open up the details.

5. Let’s look at Phone Notify! reporting features. There are two reports available, and they include a usage report and a DID report. Select “Report” to access the usage report.

6. The license key must have transactions or usage in order to run this report. You can customize the date range to suit your search needs. The Phone Notify! Report includes the date and number of calls sent, whether or not the call was answered, if a machine, voicemail, or fax picked up the call, and whether or not the call was transferred. Each report can be refreshed and viewed, as well as exported to an .xls or .csv file.

7. Select “DID” to access a list of phone numbers assigned to your Phone Notify! license key. This report will also show any associated PostBackURLs, and allow you to edit those URLS.

Test CDYNE Phone Notify! API for free.

For more information about CDYNE SMS APIs, please call 1-800-984-3710, inquire or initiate a chat.

CDYNE SMS Notify! Account Reporting Features

Posted by: CDYNE  /  Tags: , , , , ,

SMS API Reports

CDYNE Corporation offers helpful account reporting features for SMS Notify! API, a two way SMS gateway API that sends and receives SMS text messages worldwide. These reports allow you to view outgoing and incoming text message data including the To or From phone number, text message status, sent date and time, the unique Message ID for each message, as well as the message itself. You can customize the reports to view the most recent number of transactions, specify a date range, or search by phone number. All reports can be exported to an .xls or.csv file. It is simple to access the reports by following these steps.

1. Log into your account online at http://www.cdyne.com/ in the upper-right hand corner.

2. Once logged in, select “Manage Services” on the left-hand gray menu.

3. After selecting Manage Services, you will navigate to a page listing your active and inactive Web Services. Active Web Services will be listed on the top of the page.

4. Select an active service to open up the details. Let’s start with SMS Notify! to look at the reporting features.

5. There are two reports available, and they include a usage report and a DID report. Select “Report” to access the usage report.

6. The following image shows an example of a usage report. The license key must have transactions or usage in order to run this report. There are several options to customize the report to your needs. They include the number of most recent transactions, a date range, or a search by phone number. Each report can be refreshed and viewed, as well as exported to an .xls or .csv file. The SMS Notify! report includes the type of message (outgoing or incoming), the to/from phone number, the status of the message, the date and time is was sent from SMS Notify! API, message ID, and the text message.

7. Select “DID” to access a list of phone numbers assigned to your SMS Notify! license key. This report will also show any associated PostBackURLs, and allow you to edit those URLS.

Test CDYNE SMS Notify! API for free.

For more information about CDYNE SMS APIs, please call 1-800-984-3710, inquire or initiate a chat.

CDYNE Phone Verification Now Available With “Denali” Community Technology Preview 3

Posted by: CDYNE  /  Tags: , , , , , , , ,

CDYNE Phone Verification

CDYNE Phone Verification is now available with the release of Microsoft SQL Server Code Name “Denali” Community Technology Preview 3 (CTP3). It was released yesterday, and publicly announced at Microsoft’s Worldwide Partner Conference (WPC). New capabilities include greater availability, unprecedented performance, credible and consistent data, and a productive development experience.

CDYNE Corporation is proud to be an integrated marketplace provider for Phone Verification, which will validate the first 7 digits of your phone number(s) and return what carrier the phone number id is assigned to, whether it is a cellular number or a land line, the telco, and additional information including time zone, area code and email address if it is a cellular number.

You can find more information about CDYNE Phone Verification on Denali here.

SMS-Enable Your Apps for Only 1 Cent per Text Message Worldwide

Posted by: CDYNE  /  Tags: , , , , , , , , , ,

CDYNE SMS Notify! API Price Reduction

CDYNE Announces New Lower SMS API Pricing

Effective immediately, CDYNE is cutting the price of all text messaging transactions to 1 cent. This includes all text messages sent to CDYNE’s worldwide network.

SMS Notify! 2.0 is a 2-way text messaging Web Service that sends and receives text messages through secure SMS gateways. Commonly used messaging features include automated appointment or payment reminders, product delivery status notifications, and subscriber event messaging.

Automated Keyword Management

In addition to cutting the price of SMS transactions, CDYNE has added automated keyword management features into SMS Notify! 2.0. SMS message recipients who type HELP, STOP, END, CANCEL, UNSUBSCRIBE, and QUIT keywords will now receive an automated acknowledgement.

When a CDYNE SMS Notify! 2.0 recipient types “HELP” CDYNE will automatically send back a default string with company name, contact information and STOP instructions to end text messages. This allows the recipient to know who is contacting them, and provides them with information on how they can contact the sender. SMS Notify! 2.0 users have the option to customize the HELP return string.

CDYNE SMS Notify! 2.0 automatically manages the STOP, END, CANCEL, UNSUBSCRIBE, and QUIT keywords. When an SMS recipient sends any of these keywords, CDYNE will send an automated acknowledgement. This will block the recipient’s number from receiving messages from our system in an effort to protect them from unwanted or unsolicited messages.

Free SMS API Test Keys

Sign up today to test CDYNE SMS Notify! 2.0 for free.

For more information about CDYNE SMS APIs, please call 1-800-984-3710, inquire or initiate a chat.

HOW SMS NOTIFY! API HANDLES INVALID PHONE NUMBERS

Posted by: CDYNE  /  Tags: , , , , , , ,

Di the text message make it to its destination?

What happens when a user tries to send SMS text messages to an invalid phone number? Fortunately, CDYNE’s SMS Notify! SMS Gateway API will automatically clean up certain errors for U.S. and Canadian phone numbers. For example, if you were to send a message to “7575449510e,” the API would take out the “e” and send the message to 7575449510. In this example, SMS Notify! API would return a parameter of “NoError” and continue to send the message to the cleaned up phone number.

The correct format to send U.S. and Canadian numbers is a string such as 7575551234. The International phone number format is a string that includes 011 + country code + number.

While the SMS Notify! text message API will clean errors such as extra digits and/or letters, it will not clean numbers if it has been entered incorrectly and is still a valid number.  For example if you wanted to send a notification to 7575449510, but instead you had the number as 7575449501 within your script, the message would be sent to 7575449501 as it is a valid number.

So when will SMS Notify! API return a “PhoneNumberInvalid” error?

One example is when a phone number contains a character plus six numbers – such as when the letter “o” takes the place of the number zero. A second example is a series of fives, such as 555-555-5555. The image below shows how SMS Notify! will handle these.

When an error occurs due to an invalid phone number, the notification will not be sent to the intended recipient.  However, the account will still be charged for the transaction. The charge takes place because a request was sent to CDYNE and a response was received from CDYNE servers.

What happens if I send a landline phone number to SMS Notify! API?

CDYNE SMS Notify! API does not do a phone verification check on phone numbers, and it will send all valid numbers out. One work around is to run your phone list through CDYNE Phone Verification API which will return whether a phone number is a landline or cell number. CDYNE Phone Verification API is a cost effective way to distinguish between a landline and cellular or even fake phone numbers. Ask about discounts when used in conjunction with SMS Notify! or Phone Notify! APIs.

Sign up for a free trial key to test the Web Services for free!

You can sign up for a trial license key to test SMS Notify! API and Phone Verification for free. For more information about CDYNE Web Services, please call 1-800-984-3710, inquire or initiate a chat.

Say It in Spanish, Canadian French, and German: CDYNE Phone Notify! API Features Three New Text-To-Speech Voices

Posted by: CDYNE  /  Tags: , , , , , , , , , , , , , , , ,

Spanish-Text-to-speech

CDYNE has upgraded its existing text-to-speech (TTS) voices, as well as added three new voices to the text-to-speech engine. With the addition of TTS voices Miguel, Jean-Pierre, and Matthias, your business can add scalable, multilingual, and customizable voice calls to your application. All voices have an 8kHz sampling rate. This is best suited to telephony applications because it eliminates the overhead that is incurred when using voices of a higher sampling rate.

New voices details:

  • Miguel (Americas Spanish), Male, Age 30 –  sample
  • Jean-Pierre (Canadian French) , Male, Age 30 - sample
  • Matthias (German) , Male, Age 30 – sample

All voices may be found here.

CDYNE’s text-to-speech engine converts raw text to written-out words, and then assigns phonetic transcriptions to those words. Text-to-speech can also be combined with recorded .wav files to create relevant call scripts according to your phone messaging web service needs. Call 704-323-7777 to listen to a sample recorded file and text-to-speech example.

Request a trial key to test Phone Notify! API for free by calling 1-800-984-3710, inquire or initiate a chat.

New Methods Added to Postal Address Verification

Posted by: CDYNE  /  Tags: , , , , , , , , , , , , , ,

CDYNE PAV GetZipCodesWithinDistance Operation

     CDYNE has added two new methods to the Postal Address Verification API to allow users to get zip codes within a radius, as well as searching for zip codes within a county with FIPS county code data. With the GetZipCodesWithinDistance operation, CDYNE Postal Address Verification users can add a zip code radius search, or proximity search to their websites.

     The second operation is GetZipCodesForFips. Federal information processing standards codes (FIPS codes) are a standardized set of numeric or alphabetic codes issued by the National Institute of Standards and Technology (NIST) to ensure uniform identification of geographic entities through all federal government agencies.

1. GetZipCodesWithinDistance

Add zip code radius search, or proximity search to your website or software with GetZipCodesWithinDistance. You specify the miles and latitude/longitude values, and the method will return all zip codes within the radius given.

Features and Benefits

  • Geo target for advertising
  • Specify targets within a radius
  • Program “dealer locator” or “nearby locations” based on latitude and longitude coordinates


Required Fields

  • Latitude
  • Longitude
  • Radius (0 – 50)
  • License key (Click here to get a trial license key)


Returned Fields 

  • Return Code
    • 0 – Success
    • 1 – Invalid Input
    • 2 – Invalid License Key
    • 3 – Returned 0 Zip Codes
    • 4 – Outside Of Latitude/Longitude Range
  • Zip Codes – returns an array of zip codes within range

 

2. GetZipCodesForFips

Search zip codes within a county with FIPS county code data.

Federal information processing standards codes (FIPS codes) are a standardized set of numeric or alphabetic codes issued by the National Institute of Standards and Technology (NIST) to ensure uniform identification of geographic entities through all federal government agencies. The entities covered include: states and statistically equivalent entities, counties and statistically equivalent entities, named populated and related location entities (such as, places and county subdivisions), and American Indian and Alaska Native areas.


Required Fields 

  • FIPS value (string)
  • License key (Click here to get a trial license key)
  • 

Returned Fields

  • Return Code
    • 0 – Success
    • 1 – Invalid Input
    • 2 – Invalid License Key
    • 3- Returned 0 Zip Codes
  • Zip Codes – returns an array of zip codes related to FIPS

 

For more information:

WSDL: http://pav3.cdyne.com/PavService.svc?wsdl
Developer Resources: http://wiki.cdyne.com/wiki/index.php?title=Postal_Address_Verification
Product Web Page: http://www.cdyne.com/products/postal-address-verification.aspx

Page 1 of 3 123