
Identity Verification
| Field Name | Len | Type | Req | Ver | Comments |
|---|---|---|---|---|---|
| method | N/A | Alp-Num | Yes | 1.1 | identityVerificationInquiry |
| fromEmail | N/A | Alp-Num | Yes | 1.1 | The email associated with the account from which the amount is deducted |
| identityVerificationId | N/A | Num | -- | 1.1 | The ID associated with the identity verification query (optional) |
| key | N/A | Alp-Num | Yes | 1.1 | MD5(sharedSecret + identityVerificationId) |
This request is responded by a message with the following content:
| Field Name | Len | Type | Mdt | Ver | Comments |
|---|---|---|---|---|---|
| ResponseCode | N/A | Alp-Num | Yes | 1.1 | The response code; 00 = Success; |
| ResponseDescription | N/A | Alp-Num | Yes | 1.1 | Human readable response |
| Fee | N/A | Real | Yes | 1.1 | Fee for the current transaction |
| Verifications/ Verification/ TransactionId | N/A | Num | Yes | 1.1 | The transaction ID |
| Verifications/ Verification/ Email | N/A | Alp-Num | Yes | 1.1 | The email that was submitted to identity verification |
| Verifications/ Verification/ FirstName | N/A | Alp | Yes | 1.1 | The First Name that was submitted to identity verification |
| Verifications/ Verification/ LastName | N/A | Alp | Yes | 1.1 | The Last Name that was submitted to identity verification |
| Verifications/ Verification/ BusinessName | N/A | Alp-Num | Yes | 1.2 | The Business Name that was submitted to identity verification |
| Verifications/ Verification/ Gender | N/A | Alp | Yes | 1.1 | The gender that was submitted to identity verification |
| Verifications/ Verification/ Address | N/A | Alp-Num | Yes | 1.1 | The Address that was submitted to identity verification |
| Verifications/ Verification/ City | N/A | Alp | Yes | 1.1 | The City that was submitted to identity verification |
| Verifications/ Verification/ State | 2 | Alp-Num | Yes | 1.1 | The State that was submitted to identity verification |
| Verifications/ Verification/ Country | 2 | Alp | Yes | 1.1 | The Country that was submitted to identity verification |
| Verifications/ Verification/ PostalCode | N/A | Alp-Num | Yes | 1.1 | The Postal Code that was submitted to identity verification |
| Verifications/ Verification/ Birthday | 10 | Date | Yes | 1.1 | The Birthday that was submitted to identity verification |
| Verifications/ Verification/ Phone | N/A | Num | Yes | 1.1 | The Phone Number that was submitted to identity verification |
| Verifications/ Verification/ IdType | 1 | Num | Yes | 1.1 | The ID Type that was submitted to identity verification |
| Verifications/ Verification/ IdNumber | N/A | Alp-Num | Yes | 1.1 | The ID Number that was submitted to identity verification |
| Verifications/ Verification/ ResultEmail | 1 | Num | Yes | 1.1 | 4 = Not Matched ( and all the other fields are 0 = Not Checked ) 2 = Matched |
| Verifications/ Verification/ ResultFirstName | 1 | Num | Yes | 1.1 | 1 = Not Matched 2 = Matched 3 = Partial Matched |
| Verifications/ Verification/ ResultLastName | 1 | Num | Yes | 1.1 | 1 = Not Matched 2 = Matched 3 = Partial Matched |
| Verifications/ Verification/ ResultBusinessName | 1 | Num | Yes | 1.2 | 1 = Not Matched 2 = Matched 3 = Partial Matched |
| Verifications/ Verification/ ResultGender | 1 | Num | Yes | 1.1 | 1 = Not Matched 2 = Matched |
| Verifications/ Verification/ ResultAddress | 1 | Num | Yes | 1.1 | 1 = Not Matched (lower 35 %) 3 = Partial Matched (between 35 - 75 %) 2 = Matched (over 75 %) |
| Verifications/ Verification/ ResultCity | 1 | Num | Yes | 1.1 | 1 = Not Matched 2 = Matched |
| Verifications/ Verification/ ResultState | 1 | Num | Yes | 1.1 | 1 = Not Matched 2 = Matched4 = Not Found |
| Verifications/ Verification/ ResultCountry | 1 | Num | Yes | 1.1 | 1 = Not Matched 2 = Matched |
| Verifications/ Verification/ ResultPostalCode | 1 | Num | Yes | 1.1 | 1 = Not Matched 2 = Matched |
| Verifications/ Verification/ ResultBirthday | 1 | Num | Yes | 1.1 | 1 = Not Matched 2 = Matched |
| Verifications/ Verification/ ResultPhone | 1 | Num | Yes | 1.1 | 1 = Not Matched 2 = Matched |
| Verifications/ Verification/ ResultIdType | 1 | Num | Yes | 1.1 | 1 = Not Matched 2 = Matched 4 = Not Found |
| Verifications/ Verification/ ResultIdNumber | 1 | Num | Yes | 1.1 | 0 = Not Checked (if IdType = 4) 1 = Not matched 2 = Matched |
Request Sample:
https://secure.paxum.com/payment/api/paymentAPI.php
POST
method=identityVerificationInquiry&fromEmail=payee%40domain.com&identityVerificationId=123456&key=ec573a81ca2d4f236795db7118ac6f39
Response Sample
<?xml version="1.0"?>
<Response>
<Environment>PRODUCTION</Environment>
<Method>identityVerificationInquiry</Method>
<ResponseCode>00</ResponseCode>
<ResponseDescription>Approved or Completed Successfully</ResponseDescription >
<Fee>0.00</Fee>
<Verifications>
<Verification>
<TransactionId>23646236</TransactionId>
<Email>[email protected]</Email>
<FirstName>John</FirstName>
<LastName>Smith</LastName>
<BusinessName>John Smith INC</BusinessName>
<Gender>1</Gender>
<Address>street address</Address>
<City>New York</City>
<State>NY</State>
<Country>US</Country>
<PostalCode>12345</PostalCode>
<Birthday>1975-05-08</Birthday>
<Phone>1234567891</Phone>
<IdType>1</IdType>
<IdNumber>12354gh</IdNumber>
<ResultEmail>2</ResultEmail>
<ResultFirstName>1</ResultFirstName>
<ResultLastName>2</ResultLastName>
<ResultBusinessName>2</ResultBusinessName>
<ResultGender>2</ResultGender>
<ResultAddress>3</ResultAddress>
<ResultCity>2</ResultCity>
<ResultState>2</ResultState>
<ResultCountry>2</ResultCountry>
<ResultPostalCode>1</ResultPostalCode>
<ResultBirthday>2</ResultBirthday>
<ResultPhone>2</ResultPhone>
<ResultIdType>4</ResultIdType>
<ResultIdNumber>0</ResultIdNumber>
</Verification>
.....
<Verifications>
</Response>
Working Sample(s):
identityVerificationInquiry.php