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);
    }
}