alt

Important information

The API reference is now available here.
The deprecated API reference is available here.

Unzer

Additional transaction data

Additional transaction data is used for passing extra data required for a transaction.

Transactions could contain additionalTransactionData, in general these can be added to a Charge or Authorization transaction using the setAdditionalTransactionData() method when needed.

Field Description
card Card transaction data
shipping Shipping transaction data
riskData Risk transaction data
paypal Paypal transaction data

Card transaction data

Java-SDK provides method for setting card data AdditionalTransactionData::setCard(CardTransactionData)

Field Description Values
recurrenceType Recurrence type used for recurring payment. See more at Scheduled payments RecurrenceType.SCHEDULED, RecurrenceType.UNSCHEDULED, RecurrenceType.ONECLICK
exemptionType Exemption type used for low-value payment transactions. See more at Low-Value Payments ExemptionType.LVP
liability
  read-only
Liability shift indicator. See more at Liability shift Liability.MERCHANT, Liability.ISSUER
class AdditionalTransactionDataExample {
    void cardDataExample() {
        Authorize authorize = new Authorize();

        CardTransactionData cardData = new CardTransactionData()
                .setExemptionType(CardTransactionData.LVP)
                .setRecurrenceType(RecurrenceType.SCHEDULED);

        AdditionalTransactionData additionalTransactionData = new AdditionalTransactionData();
        additionalTransactionData.setCard(cardData);

        authorize.setAdditionalTransactionData(additionalTransactionData);
    }
}

Shipping transaction data

Java-SDK provides method for setting shipping data AdditionalTransactionData::setShipping(ShippingTransactionData)

Field Description
deliveryTrackingId Tracking ID from shipping from merchant to customer.
deliveryService Delivery service from shipment from merchant to customer.
returnTrackingId Tracking ID from shipping from merchant to customer
class AdditionalTransactionDataExample {
    void shippingDataExample() {
        Authorize authorize = new Authorize();

        ShippingTransactionData shippingData = new ShippingTransactionData()
                .setDeliveryTrackingId("random-id")
                .setDeliveryService("random-id")
                .setReturnTrackingId("random-id");

        AdditionalTransactionData additionalTransactionData = new AdditionalTransactionData();
        additionalTransactionData.setShipping(shippingData);

        authorize.setAdditionalTransactionData(additionalTransactionData);
    }
}

Risk transaction data

Java-SDK provides method for setting shipping data AdditionalTransactionData::setRiskData(RiskTransactionData). See more Provide the customer risk information

Field Description Values
threatMetrixId The ThreatMetrix session ID Any String
customerGroup Customer classification for the customer. CustomerGroup.TOP, CustomerGroup.GOOD, CustomerGroup.NEUTRAL, CustomerGroup.BAD
registrationLevel Customer registration level RegistrationLevel.GUEST, RegistrationLevel.REGISTERED
registrationDate Customer registration date in your shop Any java.util.Date
customerId Customer ID Unzer-format ID String: "s-cst-..."
confirmedOrders The number of successful transactions paid by the end customer Positive integer: 10
confirmedAmount The amount/value of the successful transactions paid by the end customer Double: 891.12
class AdditionalTransactionDataExample {
    void riskDataExample() {
        Authorize authorize = new Authorize();

        RiskTransactionData riskData = new RiskTransactionData()
                .setConfirmedAmount(2569.0)
                .setConfirmedOrders(14)
                .setRegistrationLevel(RiskData.RegistrationLevel.REGISTERED)
                .setCustomerGroup(RiskData.CustomerGroup.GOOD)
                .setRegistrationDate(new Date());

        AdditionalTransactionData additionalTransactionData = new AdditionalTransactionData();
        additionalTransactionData.setRiskData(riskData);

        authorize.setAdditionalTransactionData(additionalTransactionData);
    }
}

Paypal transaction data

Java-SDK provides method for setting Paypal data AdditionalTransactionData::setPaypal(PaypalData).

Field Description Values
checkoutType Checkout type for Paypal transaction. See more: Paypal Express CheckoutType.EXPRESS
class AdditionalTransactionDataExample {
    void paypalDataExample() {
        Authorize authorize = new Authorize();

        PaypalData paypalData = new PaypalData()
                .setCheckoutType(CheckoutType.EXPRESS);

        AdditionalTransactionData additionalTransactionData = new AdditionalTransactionData();
        additionalTransactionData.setPaypal(paypalData);

        authorize.setAdditionalTransactionData(additionalTransactionData);
    }
}