com.safecharge.request.Authorization3DRequest Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of safecharge-sdk-java Show documentation

SafeCharge’s REST API SDK for Java provides developer tools for accessing Safecharge's REST API. SafeCharge’s REST API is a simple, easy to use, secure and stateless API, which enables online merchants and service providers to process consumer payments through SafeCharge’s payment gateway. The API supports merchants of all levels of PCI certification, from their online and mobile merchant applications, and is compatible with a large variety of payment options, i.e. payment cards, alternative payment methods, etc.

There is a newer version: 1.7.11

Show newest version

package com.safecharge.request;

import javax.validation.constraints.*;

import com.safecharge.request.builder.SafechargeCCBuilder;
import com.safecharge.util.APIConstants;
import com.safecharge.util.Constants;
import com.safecharge.util.ValidChecksum;
import com.safecharge.util.ValidationUtils;

/**
 * Copyright (C) 2007-2017 SafeCharge International Group Limited.
 * 
 * Request to start the 3D secure payment process.
 * 
 * This is the initial stage of the 3D secure payment process, providing the merchant with the necessary data,
 * and provides the card issuer/bank with the verification page URL.
 *
 * @author Nikola Dichev
 * @see Payment3DRequest
 * @since 2/17/2017
 */
@ValidChecksum(orderMappingName = Constants.ChecksumOrderMapping.API_GENERIC_CHECKSUM_MAPPING)
public class Authorization3DRequest
        extends SafechargeCCRequest {

    /**
     * This parameter determines whether the 3DSecure rule engine is to be managed by SafeCharge (1)
     * or the 3DSecure rule engine not managed by SafeCharge and method will always try to
     * send a 3DSecure transaction (0).
     */
    @Pattern(regexp = APIConstants.IS_DYNAMIC_3D_REGEX, message = "isDynamic3D value is invalid")
    private String isDynamic3D;

    @Size(max=5)
    private String dynamic3DMode;

    public static Builder builder() {
        return new Builder();
    }

    public String getIsDynamic3D() {
        return isDynamic3D;
    }

    public void setIsDynamic3D(String isDynamic3D) {
        this.isDynamic3D = isDynamic3D;
    }

    public String getDynamic3DMode() {
        return dynamic3DMode;
    }

    public void setDynamic3DMode(String dynamic3DMode) {
        this.dynamic3DMode = dynamic3DMode;
    }

    @Override
    public String toString() {
        final StringBuilder sb = new StringBuilder("Authorization3DRequest{");
        sb.append(super.toString());
        sb.append('}');
        return sb.toString();
    }

    public static class Builder extends SafechargeCCBuilder {

        private String isDynamic3D;
        private String dynamic3DMode;

        /**
         * Adds the Dynamic3D parameter.
         *
         * @param isDynamic3D This parameter determines whether the 3DSecure rule engine is to be managed by SafeCharge (1)
         *                    or the 3DSecure rule engine not managed by SafeCharge and method will always try to
         *                    send a 3DSecure transaction (0).
         * @return this object
         */
        public Builder addIsDynamic3D(String isDynamic3D, String dynamic3DMode) {
            this.isDynamic3D = isDynamic3D;
            this.dynamic3DMode = dynamic3DMode;
            return this;
        }

        /**
         * {@inheritDoc}
         */
        @Override
        public SafechargeRequest build() {
            Authorization3DRequest request = new Authorization3DRequest();
            request.setIsDynamic3D(isDynamic3D);
            request.setDynamic3DMode(dynamic3DMode);
            return ValidationUtils.validate(super.build(request));
        }
    }
}