Developers / API / Identity Verification
Identity Verification

Identity Verification

Here you can verify informations about paxum clients

Field Name Len Type Req Ver Comments
method N/A Alp-Num Yes 1.1 identityVerification
fromEmail N/A Alp-Num Yes 1.1 The email associated with the account from which the amount is deducted
toEmail N/A Alp-Num Yes 1.1 The email associated with the account where the amount is transfered to
firstName N/A Alp -- 1.1 First name + middle name
lastName N/A Alp -- 1.1 Last name
gender 1 Num -- 1.1 0 = male
1 = female
address N/A Alp-Num -- 1.1 Street Address
city N/A Alp -- 1.1 City
state 2 / 3 Alp -- 1.1 two - three letters state / province / county code (ISO 3166-2)
country 2 Alp -- 1.1 two letters country code (ISO Char 2 Code)
postalCode N/A Alp-Num -- 1.1 Zip / Postal Code
birthday 10 Date -- 1.1 Date of birth (yyyy-mm-dd)
phone 10 Num -- 1.1 Phone number (digits only)
idType 2 Num -- 1.1 3 = passport
4 = id card
5 = driver's license
10 = voter card
12 = state id
idNumber N/A Alp-Num -- 1.1 Document seris and number no spaces
key N/A Alp-Num -- 1.1 MD5(sharedSecret + toEmail + firstName + lastName + gender + address + city + state + country + postalCode + birthday + phone + idType + idNumber)

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
TransactionId N/A Num Yes 1.1 The transaction ID if successfully, otherwise not specified
Verification/ Email 1 Num Yes 1.1 4 = Not Matched ( and all the other fields are 0 = Not Checked )
2 = Mached
Verification/ FirstName 1 Num Yes 1.1 1 = Not Matched
2 = Mached
Verification/ LastName 1 Num Yes 1.1 1 = Not Matched
2 = Mached
Verification/ Gender 1 Num Yes 1.1 1 = Not Matched
2 = Mached
Verification/ Address 1 Num Yes 1.1 1 = Not Matched (lower 35 %)
3 = Partial Mached (between 35 - 75 %)
2 = Partial Mached (over 75 %)
Verification/ City 1 Num Yes 1.1 1 = Not Matched
2 = Mached
Verification/ State 1 Num Yes 1.1 1 = Not Matched
2 = Mached4 = Not Found
Verification/ Country 1 Num Yes 1.1 1 = Not Matched
2 = Mached
Verification/ PostalCode 1 Num Yes 1.1 1 = Not Matched
2 = Mached
Verification/ Birthday 1 Num Yes 1.1 1 = Not Matched
2 = Mached
Verification/ Phone 1 Num Yes 1.1 1 = Not Matched
2 = Mached
Verification/ IdType 1 Num Yes 1.1 1 = Not Matched
2 = Mached
4 = Not Found
Verification/ IdNumber 1 Num Yes 1.1 0 = Not Checked (if IdType = 4)
1 = Not matched
2 = Mached

Request Sample:

https://www.paxum.com/payment/api/paymentAPI.php

POST

method=identityVerification&fromEmail=payee%40domain.com&toEmail=payer%40domain.com&firstName=firstName&lastName=lastName&gender=0&address=address&city=city&state=state&country=country&postalCode=123456&birthday=1970-01-01&phone=0123456789&idType=3&idNumber=123456&key=ec573a81ca2d4f236795db7118ac6f39

Response Sample

<?xml version="1.0"?>
<Response>
	<Method>identityVerification</Method>
	<ResponseCode>00</ResponseCode>
	<ResponseDescription>Approved or Completed Successfully</ResponseDescription >
	<Fee>0.00</Fee>
	<TransactionId>23646236</TransactionId>
	<Verification>
		<Email>2</Email>
		<FirstName>1</FirstName>
		<LastName>2</LastName>
		<Gender>2</Gender>
		<Address>3</Address>
		<City>2</City>
		<State>2</State>
		<Country>2</Country>
		<PostalCode>1</PostalCode>
		<Birthday>2</Birthday>
		<Phone>2</Phone>
		<IdType>4</IdType>
		<IdNumber>0</IdNumber>
	</Verification>
</Response>

Working Sample(s):

identityVerification.php