The developer.datatrans.com Developer Hub

Welcome to the developer.datatrans.com developer hub. You'll find comprehensive guides and documentation to help you start working with developer.datatrans.com as quickly as possible, as well as support if you get stuck. Let's jump right in!

When using either the Payment Page or our Mobile SDKs you can register a webhook URL (POST URL) within our Webadmin Tool. The registred webhook URL will be triggered after a successful or erroneous transaction. Supported Content-Types are:

  • text/xml
  • application/x-www-form-urlencoded

Receiving the webhook payload

Success case

<?xml version="1.0" encoding="UTF-8"?>
<uppTransactionService version="1">
  <body merchantId="1000011011" testOnly="yes">
    <transaction refno="840973" status="success">
      <uppTransactionId>180710155401925243</uppTransactionId>
      <amount>1000</amount>
      <currency>CHF</currency>
      <pmethod>VIS</pmethod>
      <reqtype>CAA</reqtype>
      <language>en</language>
      <success>
        <authorizationCode>417485393</authorizationCode>
        <acqAuthorizationCode>155417</acqAuthorizationCode>
        <responseMessage>Authorized</responseMessage>
        <responseCode>01</responseCode>
      </success>
      <userParameters>
        <parameter name="sign">30916165706580013</parameter>       
        <parameter name="responseCode">01</parameter>
        <parameter name="expy">21</parameter>
        <parameter name="expm">12</parameter>
      </userParameters>
    </transaction>
  </body>
</uppTransactionService>
uppMsgType=post&status=success&uppTransactionId=180710155247074969&refno=735821&amount=1000&authorizationCode=258235030&sign=30916165706580013&language=en&pmethod=VIS&responseCode=01&expy=18&acqAuthorizationCode=155258&merchantId=1000011011&reqtype=CAA&currency=CHF&responseMessage=Authorized&testOnly=yes&expm=12

Error case

<?xml version="1.0" encoding="UTF-8"?>
<uppTransactionService version="1">
  <body merchantId="1000011011" testOnly="yes">
    <transaction refno="424807" status="error">
      <uppTransactionId>180710160345898172</uppTransactionId>
      <amount>1000</amount>
      <currency>CHF</currency>
      <pmethod>VIS</pmethod>
      <reqtype>CAA</reqtype>
      <language>en</language>
      <error>
        <errorCode>1403</errorCode>
        <errorMessage>declined</errorMessage>
        <errorDetail>Declined</errorDetail>
      </error>
      <userParameters>
        <parameter name="sign">30916165706580013</parameter>
        <parameter name="expy">21</parameter> 
        <parameter name="acqErrorCode">50</parameter>       
        <parameter name="expm">12</parameter>
      </userParameters>
    </transaction>
  </body>
</uppTransactionService>
uppMsgType=post&status=error&uppTransactionId=180710160458378622&refno=497184&amount=1000&errorMessage=declined&sign=30916165706580013&errorCode=1403&language=en&pmethod=VIS&expy=18&merchantId=1000011011&reqtype=CAA&errorDetail=Declined&currency=CHF&acqErrorCode=50&testOnly=yes&expm=12

Webhook


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.