Payment Process		Integration
Authorization	✔️	Payment Page	✔️
Deferred Settlement	✔️	Split Mode	✔️
Refund	✔️	Mobile SDK	✔️
Cancel	✔️
Alias	✔️

Description

The consumer pays with his good name and can, by easily registering his contact information, create an order. For the merchant this means a guaranteed payment with a high acceptance rate.
Payment Method provider website 🔗

📘
Request and response parameter reference
For a detailed description of the request and response parameters for Byjuno
please check the API Reference

Alias

Byjuno's payment registration page will not prompt the user to fill in all the necessary details.
uppCustomerDetails and additional Byjuno specific request parameters parameters needs to get included within your alias creation requests. No additional parameters are required in your requests to successfully debit a previously created Byjuno alias. Debit a previously created Byjuno's alias supports optional intrumCustomData[*] fields.

Web payment flow

Server to Server API calls

After a transactionId or alias was received by completing the payment flow on the web, the following server to server API calls can be used to do other actions.

Authorization

Request

curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_authorize.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<authorizationService version="6">
    <body merchantId="1000011011">
        <transaction refno="1503046708506">
            <request>
                <amount>2000</amount>
                <currency>CHF</currency>
                <reqtype>NOA</reqtype>
                <pmethod>INT</pmethod>
                <sign>30916165706580013</sign>
                <sub_pmethod>BYJUNO-INVOICE</sub_pmethod>
                <uppCustomerDetails>
                    <uppCustomerType>P</uppCustomerType>
                    <uppCustomerGender>female</uppCustomerGender>
                    <uppCustomerFirstName>Hanna</uppCustomerFirstName>
                    <uppCustomerLastName>Mustermann</uppCustomerLastName>
                    <uppCustomerBirthDate>1950-01-01</uppCustomerBirthDate>
                    <uppCustomerEmail>[email protected]</uppCustomerEmail>
                    <uppCustomerId>10067822</uppCustomerId>
                    <uppCustomerCellPhone>0448111111</uppCustomerCellPhone>
                    <uppCustomerPhone>0448222222</uppCustomerPhone>
                    <uppCustomerLanguage>DE</uppCustomerLanguage>
                    <uppCustomerStreet>Bahnstrasse</uppCustomerStreet>
                    <uppCustomerStreet2>1</uppCustomerStreet2>
                    <uppCustomerCity>Schwerzenbach</uppCustomerCity>
                    <uppCustomerZipCode>8603</uppCustomerZipCode>
                    <uppCustomerCountry>CHE</uppCustomerCountry>
                    <uppShippingDetails>no</uppShippingDetails>
                    <uppCustomerIpAddress>127.0.0.1</uppCustomerIpAddress>
                </uppCustomerDetails>
                <intrumDeliveryMethod>POST</intrumDeliveryMethod>
                <intrumDeviceFingerprintId>123-test</intrumDeviceFingerprintId>
                <intrumRiskOwner>IJ</intrumRiskOwner>
                <intrumPaperInvoice>NO</intrumPaperInvoice>
                <intrumRepaymentType>4</intrumRepaymentType>
            </request>
        </transaction>
    </body>
</authorizationService>
EOF

Response

<?xml version='1.0' encoding='UTF-8'?>
<authorizationService version='6'>
  <body merchantId='1000011011' status='accepted'>
    <transaction refno='1503046708506' trxStatus='response'>
      <request>
        <amount>2000</amount>
        <currency>CHF</currency>
        <reqtype>NOA</reqtype>
        <pmethod>INT</pmethod>
        <sign>30916165706580013</sign>
        <sub_pmethod>BYJUNO-INVOICE</sub_pmethod>
        <uppCustomerDetails>
          <uppCustomerType>P</uppCustomerType>
          <uppCustomerGender>female</uppCustomerGender>
          <uppCustomerFirstName>Hanna</uppCustomerFirstName>
          <uppCustomerLastName>Mustermann</uppCustomerLastName>
          <uppCustomerBirthDate>1950-01-01</uppCustomerBirthDate>
          <uppCustomerEmail>[email protected]</uppCustomerEmail>
          <uppCustomerId>10067822</uppCustomerId>
          <uppCustomerCellPhone>0448111111</uppCustomerCellPhone>
          <uppCustomerPhone>0448222222</uppCustomerPhone>
          <uppCustomerLanguage>DE</uppCustomerLanguage>
          <uppCustomerStreet>Bahnstrasse</uppCustomerStreet>
          <uppCustomerStreet2>1</uppCustomerStreet2>
          <uppCustomerCity>Schwerzenbach</uppCustomerCity>
          <uppCustomerZipCode>8603</uppCustomerZipCode>
          <uppCustomerCountry>CHE</uppCustomerCountry>
          <uppShippingDetails>no</uppShippingDetails>
          <uppCustomerIpAddress>127.0.0.1</uppCustomerIpAddress>
        </uppCustomerDetails>
        <intrumDeliveryMethod>POST</intrumDeliveryMethod>
        <intrumDeviceFingerprintId>123-test</intrumDeviceFingerprintId>
        <intrumRiskOwner>IJ</intrumRiskOwner>
        <intrumPaperInvoice>NO</intrumPaperInvoice>
        <intrumRepaymentType>4</intrumRepaymentType>
      </request>
      <response>
        <responseCode>01</responseCode>
        <responseMessage>Intrum trx successful.</responseMessage>
        <uppTransactionId>180816163652995334</uppTransactionId>
        <authorizationCode>653015335</authorizationCode>
        <acqAuthorizationCode>161538413</acqAuthorizationCode>
        <allowedPaymentMethods>[&quot;BYJUNO-INVOICE&quot;]</allowedPaymentMethods>
      </response>
    </transaction>
  </body>
</authorizationService>

Settlement

Request

curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_processor.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<?xml version="1.0" encoding="UTF-8" ?>
<paymentService version="2">
  <body merchantId="1000011011">
    <transaction refno="1503046708506">
      <request>
        <amount>2000</amount>
        <currency>CHF</currency>
        <uppTransactionId>180816163652995334</uppTransactionId>
      </request>
    </transaction>
  </body>
</paymentService>
EOF

Response

<?xml version='1.0' encoding='UTF-8'?>
<paymentService version='2'>
    <body merchantId='1000011011' status='accepted'>
        <transaction refno='1503046708506' trxStatus='response'>
            <request>
                <amount>2000</amount>
                <currency>CHF</currency>
                <uppTransactionId>180816163652995334</uppTransactionId>
                <reqtype>COA</reqtype>
                <transtype>05</transtype>
            </request>
            <response>
                <responseCode>01</responseCode>
                <responseMessage>settlement succeeded</responseMessage>
            </response>
        </transaction>
    </body>
</paymentService>

Credit

Request

curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_processor.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<?xml version="1.0" encoding="UTF-8" ?>
<paymentService version="2">
  <body merchantId="1000011011">
    <transaction refno="1503046708506">
      <request>
        <amount>2000</amount>
        <currency>CHF</currency>
        <uppTransactionId>180816163652995334</uppTransactionId>
        <transtype>06</transtype>
      </request>
    </transaction>
  </body>
</paymentService>
EOF

Response

<?xml version='1.0' encoding='UTF-8'?>
<paymentService version='2'>
    <body merchantId='1000011011' status='accepted'>
        <transaction refno='1503046708506' trxStatus='response'>
            <request>
                <amount>2000</amount>
                <currency>CHF</currency>
                <uppTransactionId>180816163652995334</uppTransactionId>
                <transtype>06</transtype>
                <reqtype>COA</reqtype>
            </request>
            <response>
                <responseCode>01</responseCode>
                <responseMessage>credit succeeded</responseMessage>
                <uppTransactionId>180816164005246928</uppTransactionId>
                <authorizationCode>896646929</authorizationCode>
                <acqAuthorizationCode>0</acqAuthorizationCode>
            </response>
        </transaction>
    </body>
</paymentService>

Cancel

Request

curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_processor.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<?xml version="1.0" encoding="UTF-8" ?>
<paymentService version="2">
  <body merchantId="1000011011">
    <transaction refno="1503046708506">
      <request>
        <amount>2000</amount>
        <currency>CHF</currency>
        <uppTransactionId>180816164155767653</uppTransactionId>
        <reqtype>DOA</reqtype>
      </request>
    </transaction>
  </body>
</paymentService>
EOF

Response

<?xml version='1.0' encoding='UTF-8'?>
<paymentService version='2'>
    <body merchantId='1000011011' status='accepted'>
        <transaction refno='1503046708506' trxStatus='response'>
            <request>
                <amount>2000</amount>
                <currency>CHF</currency>
                <uppTransactionId>180816164155767653</uppTransactionId>
                <reqtype>DOA</reqtype>
                <transtype>05</transtype>
            </request>
            <response>
                <responseCode>01</responseCode>
                <responseMessage>cancellation succeeded</responseMessage>
            </response>
        </transaction>
    </body>
</paymentService>

Status

Request

curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_status.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<?xml version="1.0" encoding="UTF-8" ?>
<statusService version="5">
  <body merchantId="1000011011">
    <transaction>
      <request>
        <uppTransactionId>180816164155767653</uppTransactionId>
        <reqtype>STX</reqtype>
      </request>
    </transaction>
  </body>
</statusService>
EOF

Response

<?xml version='1.0' encoding='UTF-8'?>
<statusService version='5'>
    <body merchantId='1000011011' status='accepted'>
        <transaction trxStatus='response'>
            <request>
                <uppTransactionId>180816164155767653</uppTransactionId>
                <reqtype>STX</reqtype>
            </request>
            <response itemNr='1'>
                <responseCode>7</responseCode>
                <responseMessage>MOA Cancel</responseMessage>
                <refno>1503046708506</refno>
                <amount>2000</amount>
                <currency>CHF</currency>
                <authorizationCode>155787654</authorizationCode>
                <pmethod>INT</pmethod>
                <uppTransactionId>180816164155767653</uppTransactionId>
                <maskedCC></maskedCC>
                <aliasCC></aliasCC>
                <expm></expm>
                <expy></expy>
                <trxDate>20180816</trxDate>
                <trxTime>164155</trxTime>
                <trtype>05</trtype>
            </response>
        </transaction>
    </body>
</statusService>

Description

📘Request and response parameter reference

Alias

Web payment flow

Server to Server API calls

Authorization

Settlement

Credit

Cancel

Status

📘
Request and response parameter reference