These docs are for v1.0.1. Click to read the latest docs for v2.1.0.

Byjuno

120

paymentmethod=INT

Payment ProcessIntegration
Authorization:heavy-check-mark:Payment Page:heavy-check-mark:
Deferred Settlement:heavy-check-mark:Split Mode:heavy-check-mark:
Refund:heavy-check-mark:Mobile SDK:heavy-check-mark:
Cancel:heavy-check-mark:
Alias:heavy-check-mark:

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

📘

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

 1 
[Not supported by viewer]
Customer clicks Pay
Customer clicks Pay
Merchant Website
Merchant Website
Merchant Server
Merchant Server
Payment Page loaded from Datatrans
Payment Page loaded from Datatrans
Byjuno
Byjuno<br>
 3 
[Not supported by viewer]
Customer enters account information and selects mode of payment (e.g. installments, purchase on account)
[Not supported by viewer]
 2 
[Not supported by viewer]
 4 
[Not supported by viewer]
Validates and prepares forwarding to Acquirer
Validates and prepares forwarding to Acquirer
Authorization /  Credit Check / Forwarding
Authorization /  Credit Check / Forwarding
 6 
[Not supported by viewer]
Receives Result 
Receives Result 
 7 
[Not supported by viewer]
Invokes merchant's
POST URL (Webhook)
Invokes merchant's<br>POST URL (Webhook)
Receives Result 
Receives Result 
 8 
[Not supported by viewer]
Redirects customer back to merchant
Redirects customer back to merchant
Customer gets redirected to merchant page
Customer gets redirected to merchant page
 5 
[Not supported by viewer]
 6.1 
[Not supported by viewer]

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>