mpValidate

The mpValidate service is called by the merchant when the consumer returns from the MP site. It verifies the consumer’s request and fetches the card data for the consumer’s chosen payment method. In some cases it also retrieves the shipping address

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>
Do you have a question or need help?
Follow us
DIBS Payment Services
Stockholm +46 (0)8-527 525 00
Göteborg +46 031-600 800
København +45 7020 3077
Oslo +47 21 55 44 00