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 |
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>