mpValidate - DIBS Technical Documentation

Input parameters

Parameter name	Description
shopName	Merchant shopname, provided by DIBS
userName	API-Username, generated by merchant in DIBS Manager
password	API-User password, generated by merchant in DIBS Manager
verifyID	DIBS reference number, this must the same as the verifyID returned from the mpInitForm response
oAuthToken	Parameter oAuthToken passed by Masterpass to shop
oAuthVerifier	Parameter oAuthVerifier passed by Masterpass to shop
checkoutResourceUrl	Parameter checkoutResourceUrl passed by Masterpass to shop
extra	Please refer to the description of the 'extra' parameter on the Web Service page.
MAC	MAC should be included in the 'extra' parameter described above. The MAC is calculated with the following formula: verifyID&SecretKey&

Output parameters

Parameter name	Description
VerifyId	DIBS reference number
resultText	DIBS result text
resultCode	DIBS result code
amount	Transaction amount
brandId	Identifies the card brand id, for example brand id for MasterCard card is "MC"
ccType	Type of credit card(for example, MasterCard)
ccPart	Masked card number
cardExpMonth	Expiry month of the selected creditcard. This value is provided by Masterpass.
cardExpYear	Expiry year of the selected creditcard. This value is provided by Masterpass.
shippingFirstName	Recipient first name
shippingLastName	Recipient last name
shippingAddressLine1	Address line 1 used for Street number and Street Name.
shippingAddressLine2	Address line 2 used for Apt Number, Suite Number ,etc.
shippingCountry	Shipping Country. Defined by ISO 3166-1 alpha-2 digit country codes e.g. US is United States, AU is Australia, CA is Canada, GB is United Kingdom, etc.
shippingCity	Shipping City
shippingZipCode	Zip code for shipping
consumerEmail	The consumer's email provided by merchant in mpInitForm
consumerPhone	The consumer's phone number provided by merchant in mpInitForm
email	The email chosen in the Masterpass wallet. This value is provided by Masterpass.
phone	The phone number chosen in the Masterpass wallet. This value is provided by Masterpass.

Example

Below is an example of a request:

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:v2="https://securedt.dibspayment.com/DTServerModuleService/v2">
   <soap:Header/>
   <soap:Body>
      <v2:mpValidate>
         <v2:shopName>ShopName</v2:shopName>
         <v2:userName>API_User</v2:userName>
         <v2:password>Password</v2:password>
         <v2:verifyID>123456</v2:verifyID>
         <v2:oAuthToken>9ff8b83014161d0555c879eebf07b3dea1e4bd8d</v2:oAuthToken>
         <v2:oAuthVerifier>203378ab82ef1ceb914093e34571dec4c1423f56</v2:oAuthVerifier>
         <v2:checkoutResourceUrl>https://api.mastercard.com/online/v5/checkout/311811919</v2:checkoutResourceUrl>
         <v2:extra>@amp;MAC=3420sdf509342f85032850342</v2:extra>
      </v2:mpValidate>
   </soap:Body>
</soap:Envelope>

And the following is an example of a response:

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:mpValidateResponse xmlns:ns="https://securedt.dibspayment.com/DTServerModuleService/v2">
         <ns:return>
            <ns:amount>100</ns:amount>
            <ns:cardBrandId>master</ns:cardBrandId>
            <ns:cardExpMonth>12</ns:cardExpMonth>
            <ns:cardExpYear>15</ns:cardExpYear>
            <ns:ccPart>****_****_****_0014</ns:ccPart>
            <ns:ccType>MasterCard</ns:ccType>
            <ns:consumerEmail xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:consumerPhone xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:email>dibstest@masterpass.com</ns:email>
            <ns:phone>1-0011223344</ns:phone>
            <ns:resultCode>114</ns:resultCode>
            <ns:resultText>validate_OK</ns:resultText>
            <ns:shippingAddressLine1 xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:shippingAddressLine2 xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:shippingCity xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:shippingCountry xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:shippingFirstName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:shippingLastName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:shippingZipCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:verifyID>123456</ns:verifyID>
         </ns:return>
      </ns:mpValidateResponse>
   </soapenv:Body>
</soapenv:Envelope>