Input parameters
Essential parameter name | Description |
---|---|
shopName * | Merchant shopname, provided by DIBS. |
userName * | API-Username, generated by merchant in DIBS Manager. |
password * | API-Password, generated by merchant in DIBS Manager. |
verifyID * | DIBS reference number, this must be the same verifyID as from the authorization response. |
paRes * | PaRes message obtained from a call to the askIf3DSEnrolled API. |
extra |
Please refer to the description of the 'extra' parameter on the Web Service page. The following MAC formula should be used for this request: X('VerifyId&SecretKey&') |
Example
Below is an example of the authorize3DS request using SOAP.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v2="https://securedt.dibspayment.com/DTServerModuleService/v2"> <soapenv:Header/> <soapenv:Body> <v2:authorize3DS> <v2:shopName>Insert your shopname here</v2:shopName> <v2:userName>Insert your API username here</v2:userName> <v2:password>Insert your API password here</v2:password> <v2:verifyID>358433619</v2:verifyID> <v2:paRes>eJxVUsFuwjAM/ZWK66Q6adOWIROJDaTBNMQYl+1WWo92jBSawNi+fkmhg/XkZ8fPz8/FRVE...</v2:paRes> <!--Optional:--> <v2:extra></v2:extra> </v2:authorize3DS> </soapenv:Body> </soapenv:Envelope>
The following is an example of a response:
<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope"> <soapenv:Body> <ns:authorize3DSResponse xmlns:ns="https://securedt.dibspayment.com/DTServerModuleService/v2"> <ns:return> <ns:aCSUrl xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:acquirerAddress xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:acquirerAuthCode/> <ns:acquirerAuthResponseCode/> <ns:acquirerCity xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:acquirerConsumerLimit xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:acquirerErrorDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:acquirerFirstName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:acquirerLastName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:acquirerMerchantLimit xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:acquirerZipCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:amount>250</ns:amount> <ns:errorMsg/> <ns:infoCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:infoDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:pAReqMsg xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <ns:resultCode>100</ns:resultCode> <ns:resultText>verification_OK</ns:resultText> <ns:verifyID>358433619</ns:verifyID> </ns:return> </ns:authorize3DSResponse> </soapenv:Body> </soapenv:Envelope>