Difference between revisions of "PAV International"

From CDYNE Wiki
Jump to navigation Jump to search
imported>Nfesette
(Minimum Input Data)
 
(43 intermediate revisions by 5 users not shown)
Line 1: Line 1:
CDYNE PAV-I is an international postal address verification API which validates and standardizes addresses for over 240 countries. Businesses can ensure data quality for their international customer base and gain global customer contact information efficiently at point of entry. There is no prior knowledge of international address formats required. PAV-I takes the guesswork out of the many international address formats and foreign characters that exist worldwide.
+
'''PAV-I was discontinued in March 2013. We sincerely appreciate your support and regret any inconvenience this may cause.'''
  
PAV-I complements [http://wiki.cdyne.com/index.php/Postal_Address_Verification CDYNE PAV], a CASS Certified™ API which verifies U.S. and Canadian addresses. Although PAV-I also validates US and Canadian addresses, it is recommended to use the PAV API as it is CASS Certified™ by the United States Postal Service and provides 98.5% correction accuracy for US addresses.
+
[http://cdyne.com/products/international-address-verification.aspx CDYNE PAV-I] is an international postal address verification API which validates and standardizes addresses for over 240 countries. Businesses can ensure data quality for their international customer base and gain global customer contact information efficiently at point of entry. There is no prior knowledge of international address formats required. PAV-I takes the guesswork out of the many international address formats and foreign characters that exist worldwide.
 +
 
 +
PAV-I complements [http://wiki.cdyne.com/index.php/Postal_Address_Verification CDYNE PAV], a CASS Certified™ API which verifies U.S. and Canadian addresses.  
  
  
Line 7: Line 9:
  
  
=== PAV-I API Method ===
+
=== PAV-I API Operation ===
The method below can be found in the PAV-I Specification Sheet. Click on the link below for detailed information on this method.
+
The operation below can be found in the [http://www.cdyne.com/downloads/CDYNE_International_Postal_Verification_SPECS.pdf PAV-I Specification Sheet]. Click on the link below for detailed information on this operation.
  
 
{| class="wikitable" cellspacing="5"
 
{| class="wikitable" cellspacing="5"
 
|-
 
|-
! METHOD
+
! OPERATION
 
! align="left"| RETURN CODES
 
! align="left"| RETURN CODES
 
|-
 
|-
Line 31: Line 33:
 
=== Programming Language Examples ===
 
=== Programming Language Examples ===
  
Add examples here.
+
* [http://wiki.cdyne.com/index.php/PAV_I_CSharp CSharp] - CSharp Example <br>
 +
* [http://wiki.cdyne.com/index.php/PAV-I_PHP_CURL PHP CURL] - PHP CURL Example <br>
 +
* [http://wiki.cdyne.com/index.php/PAV-I_PHP_SOAP PHP SOAP] - PHP SOAP Example <br>
 +
* [http://vmercep.blogspot.com/2012/02/cdyne-pav-i-global-postal-address.html 3rd party C# .Net tutorial] - Video and Source
 +
* [http://wiki.cdyne.com/index.php/PAV_I_VB VB] - VB Example <br>
  
 
=== PAV-I Documentation ===
 
=== PAV-I Documentation ===
  
* [ WSDL]<br>
+
* [http://pav3.cdyne.com/i/PavInternationalService.svc?wsdl WSDL]<br>
* [ PAV-I Spec Sheet] - XML Web Service Specifications<br>
+
* [http://www.cdyne.com/downloads/CDYNE_International_Postal_Verification_SPECS.pdf PAV-I Spec Sheet] - XML Web Service Specifications<br>
* [ PAV-I service operations] at this endpoint
+
* [http://pav3.cdyne.com/i/PavInternationalService.svc/help PAV-I service operations] at this endpoint
  
 
== BEST PRACTICES ==
 
== BEST PRACTICES ==
  
 
==== Minimum Input Data ====
 
==== Minimum Input Data ====
The minimum input data is a combination of the following: Building Number, Street, Post Town, Postcode, and Country. '''''The country is required and must be input in English or ISO 2/3 country code.''''' Generally it is best to provide all the relevant input data you have for an address. Because the address format is different for different countries, PAV-I is very flexible about where you put the data.  Due to its enhanced parsing capability, entering non-address data will obfuscate matching.
+
* The minimum input data is a combination of the following: Building Number, Street, Post Town, Postcode, and Country.  
 +
* '''The country is required and must be input in English or ISO 2/3 country code.'''  
 +
* Generally it is best to provide all the relevant input data you have for an address. Because the address format is different for different countries, PAV-I is very flexible about where you put the data.   
 +
* Due to its enhanced parsing capability, entering non-address data will obfuscate matching.
 +
 
 +
==== Non-Address Data ====
 +
Non-address data should not be entered into any of the address input fields. This may impede the most accurate address verification.
  
 
==== Fielded vs. Unfielded Address Entry ====
 
==== Fielded vs. Unfielded Address Entry ====
 
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.  Address data can be entered into one address line and PAV-I will use its innovative parsing ability to properly parse the address for verification.<br>
 
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.  Address data can be entered into one address line and PAV-I will use its innovative parsing ability to properly parse the address for verification.<br>
  
[[image:FIELDEDv2.jpg|thumb=FIELDEDv2.jpg|left|Fielded]]
+
===== Fielded Address Entry =====
[[image:UNFIELDEDv2.jpg|thumb=UNFIELDEDv2.jpg|right|Unfielded]]
+
[[Image:FIELDEDv2.jpg]]
<br><br><br><br><br>
 
<br><br><br><br><br>
 
<br><br><br><br><br>
 
<br><br><br><br><br>
 
  
 +
===== Unfielded Address Entry =====
 +
[[Image:UNFIELDEDv2.jpg]]
 
<br>
 
<br>
 
==== Non-Address Data ====
 
Non-address data should not be entered into any of the address input fields. This may impede the most accurate address verification.
 
  
 
== PRODUCT FEATURES ==
 
== PRODUCT FEATURES ==
  
 
==== International Coverage ====
 
==== International Coverage ====
CDYNE Postal Address Verification International allows you to validate and standardize addresses for over 240 countries. Click here to view coverage details.
+
CDYNE Postal Address Verification International allows you to validate and standardize addresses for over 240 countries.
  
 
==== Innovative Parsing Ability ====
 
==== Innovative Parsing Ability ====
Line 68: Line 75:
  
 
==== Transliteration ====
 
==== Transliteration ====
PAV International supports the following alphabets for transliteration.
+
PAV-I supports the following alphabets for transliteration. To return addresses in a supported native language, the parameter ''ReturnNativeOutput'' must be set to true.
  
 
* Latn - Latin (English transliteration wherever possible)
 
* Latn - Latin (English transliteration wherever possible)
Line 79: Line 86:
 
* Thai - Thai (Thailand)
 
* Thai - Thai (Thailand)
 
* Hang - Hangul 한글 (South Korea)
 
* Hang - Hangul 한글 (South Korea)
 
== LICENSE KEYS AND PRICING ==
 
 
=== Free Trial License Keys ===
 
 
* CDYNE offers trial license keys for all Web Services so that you may test the APIs for free. 
 
* Trial keys do not expire, and are limited to approximately 50 transactions.
 
* Normal processing time for trial key requests during normal business hours (M-F, 9-6 eastern) typically ranges from ten minutes to two hours.
 
* Sign up here for a free trial PAV International license key.
 
 
=== Production (Account) License Keys ===
 
 
* Sign up here for a production PAV International license key.
 
* Upon registration, your account will be suspended for verification by default.
 
* The account verification process takes less than one business day to complete for account activation.
 
* You may call 1-800-984-3710 to expedite the verification process over the phone.
 
 
=== Pricing ===
 
 
Pricing for all CDYNE Web Services is based off a set monthly maintenance fee and a per-transaction fee. CDYNE does not require a contract and there are absolutely no start-up or cancellation fees. CDYNE services are post-pay. Your credit card will not be charged until one month from sign-up date and will be billed monthly thereafter unless you deactivate or cancel services. Net 30 billing is available upon application approval.
 
 
 
{| class="wikitable" cellspacing="5"
 
|-
 
! Service
 
! align="left"| Trans. Min.
 
! align="left"| Trans. Max.
 
! align="left"| Monthly
 
|-
 
 
| PAV International Monthly Fee
 
|
 
|
 
| $9.99
 
|-
 
 
| PAV International Trans fee
 
| Zero
 
| 1,000
 
| $0.0700
 
|-
 
 
| PAV International Trans fee
 
| 1,001
 
| 3,000
 
| $0.0650
 
|-
 
 
| PAV International Trans fee
 
| 3,001
 
| 10,000
 
| $0.0550
 
|-
 
 
| PAV International Trans fee
 
| 10,001
 
| 50,000
 
| $0.0500
 
|-
 
 
| PAV International Trans fee
 
| 50,001
 
| 100,000
 
| $0.0400
 
|-
 
 
| PAV International Trans fee
 
| 100,001
 
| 500,000
 
| $0.0300
 
|-
 
 
| PAV International Trans fee
 
| 500,001
 
| Unlimited
 
| $0.0250
 
|-
 
 
|}
 

Latest revision as of 15:19, 24 January 2019

PAV-I was discontinued in March 2013. We sincerely appreciate your support and regret any inconvenience this may cause.

CDYNE PAV-I is an international postal address verification API which validates and standardizes addresses for over 240 countries. Businesses can ensure data quality for their international customer base and gain global customer contact information efficiently at point of entry. There is no prior knowledge of international address formats required. PAV-I takes the guesswork out of the many international address formats and foreign characters that exist worldwide.

PAV-I complements CDYNE PAV, a CASS Certified™ API which verifies U.S. and Canadian addresses.


DEVELOPER RESOURCES

PAV-I API Operation

The operation below can be found in the PAV-I Specification Sheet. Click on the link below for detailed information on this operation.

OPERATION RETURN CODES
VerifyAddressInternational RESCODE/OUTPUT


In addition to the Return Codes listed above, PAV-I also returns the Match Level of the address. The Match Level values and their descriptions can be found below.

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

Programming Language Examples

PAV-I Documentation

BEST PRACTICES

Minimum Input Data

  • The minimum input data is a combination of the following: Building Number, Street, Post Town, Postcode, and Country.
  • The country is required and must be input in English or ISO 2/3 country code.
  • Generally it is best to provide all the relevant input data you have for an address. Because the address format is different for different countries, PAV-I is very flexible about where you put the data.
  • Due to its enhanced parsing capability, entering non-address data will obfuscate matching.

Non-Address Data

Non-address data should not be entered into any of the address input fields. This may impede the most accurate address verification.

Fielded vs. Unfielded Address Entry

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. Address data can be entered into one address line and PAV-I will use its innovative parsing ability to properly parse the address for verification.

Fielded Address Entry

FIELDEDv2.jpg

Unfielded Address Entry

UNFIELDEDv2.jpg

PRODUCT FEATURES

International Coverage

CDYNE Postal Address Verification International allows you to validate and standardize addresses for over 240 countries.

Innovative Parsing Ability

PAV-I has the ability to accept one or multiple address fields of input. See Fielded vs. Unfielded Address Entry in the Best Practices section.

Transliteration

PAV-I supports the following alphabets for transliteration. To return addresses in a supported native language, the parameter ReturnNativeOutput must be set to true.

  • Latn - Latin (English transliteration wherever possible)
  • Cyrl - Cyrillic (Russia)
  • Grek - Greek (Greece)
  • Hebr - Hebrew (Israel)
  • Hani - Kanji 漢字 (Japan)
  • Hans - Simplified Chinese 简体字(China)
  • Arab - Arabic (United Arab Emirates)
  • Thai - Thai (Thailand)
  • Hang - Hangul 한글 (South Korea)