3.0.0

• Added:
  • Added method upload_file to class DisputesClient and method files to class MerchantClient to support uploading and downloading of files for disputes.
  • Added support for binary requests and responses:
    • Added classes UploadableFile, MultipartFormDataObject and MultipartFormDataRequest for sending multipart/form-data requests.
    • Added get_with_binary_response, delete_with_binary_response, post_with_binary_response and put_with_binary_response methods to class Communicator that return, instead of a response object, a tuple with the response headers and a generator with chunks of the response body. The post, put, post_with_binary_response and put_with_binary_response methods have special support for objects of types MultipartFormDataObject and MultipartFormDataRequest.
    • Refactored interface Connection. Its methods no longer return a Response object but instead a tuple with the status code, response headers and a generator with chunks of the response body. Its post and put methods should also accept MultipartFormDataObject bodies instead of only string bodies.
    • Added method set_binary_body to class LogMessage to support logging binary content.
  • Added the following functions to module ingenico.connect.sdk.request_header:
    • get_header_value(headers, header_name) returns a single header value (or null).
    • get_header(headers, header_name) returns a single RequestHeader object (or null).
  • Added module ingenico.connect.sdk.response_header with the following methods:
    • get_header_value(headers, header_name) returns a single header value (or null).
    • get_header(headers, header_name) returns a single header as a name/value tuple (or null).
    • get_disposition_filename(headers) returns the filename of the Content-Disposition header (or null).
• Removed:
  • Removed method public_key from class ProductsClient, and class PublicKey. Both were only used for encryption for Android Pay. Now that Android Pay has been replaced by Google Pay, which uses a different mechanism for encryption, this call is no longer needed.
  • Removed deprecated methods convertAmount and getIINdetails of class ServicesClient.
  • Removed class Response in favor of streaming responses.
  • Removed property response of class ResponseException.
  • Removed method _add_parameter of class ParamRequest. Its generated sub classes directly create RequestParam objects instead of calling the more generic _add_parameter method.
  • Removed method _add_to_dictionary of class DataObject. Its generated and manually written sub classes directly add data to the dictionary instead of calling the more generic _add_parameter method.

---

If you are not using custom implementations, this version is compatible with the previous version. Otherwise you need to perform the following steps:

• If you have created your own implementation of Connection, you need to change the implementation of the get, delete, post and put methods. These should now return a tuple with the status code, response headers and a generator with chunks of the response body, and not a Response object. You also need to make sure the post and put methods accept MultipartFormDataObject bodies as well as string bodies. You probably also should take care to not log any binary request or response bodies.
• If you have extended Communicator you need to change any overridden get, delete, post and put methods to also support MultipartFormDataRequest objects. You also need to override the new get_with_binary_response, delete_with_binary_response, post_with_binary_response and put_with_binary_response methods.

2.36.0

• Added:
  • Added properties payment_product1521_specific_input, payment_product1522_specific_input, payment_product1523_specific_input, payment_product1524_specific_input and payment_product1526_specific_input to class CashPaymentMethodSpecificInput.
• Fixed:
  • Removed invalid SDK data information from the create payment request example.

2.35.0

• Added:
  • Added property third_party_data to class MerchantAction.
  • Added property payment_product861_specific_input to class RedirectPaymentMethodSpecificInput.
  • Added property open_id to class RedirectPaymentProduct863SpecificInput.
  • Added property hosted_checkout_id to classes FindPaymentsParams and FindRefundsParams.

2.34.0

This release contains several changes for 3-D Secure version 2. Several properties have been deprecated in favor of new properties. The deprecated properties will still work though.

• Added:
  • Added property vat_number to class CompanyInformation.
  • Added property merchant to classes CreateHostedCheckoutRequest, CompletePaymentRequest, CreatePaymentRequest and RiskAssessment.
  • Added properties recurring and unscheduled_card_on_file_sequence_indicator to class AbstractCardPaymentMethodSpecificInput.
  • Added property three_d_secure to classes CardPaymentMethodSpecificInput and CardPaymentMethodSpecificInputBase.
  • Added properties mobile_phone_number and work_phone_number to class ContactDetails.
  • Added properties account, account_type, device and is_previous_customer to class Customer.
  • Added properties directory_server_transaction_id, three_d_secure_version and three_d_server_transaction_id to class ExternalCardholderAuthenticationData.
  • Added property mobile_three_d_secure_challenge_parameters to class MerchantAction.
  • Added property customer to class OrderApprovePayment.
  • Added property transaction_type to class OrderTypeInformation.
  • Added property redirection_data to class RedirectPaymentMethodSpecificInput.
  • Added properties address, address_indicator, comments, first_usage_date, is_first_usage, tracking_number and type to class Shipping.
  • Added properties gift_card_purchase, is_pre_order, pre_order_item_availability_date and re_order_indicator to class ShoppingCart.
  • Added properties directory_server_transaction_id, sdk_data, three_d_secure_data, three_d_secure_version and three_d_server_transaction_id to class ThreeDSecureResults.
  • Added properties account, account_type, device and is_previous_customer to class CustomerRiskAssessment.
  • Added property shipping to class OrderRiskAssessment.
• Deprecated:
  • Deprecated property is_registered_customer of class AirlineData in favor of new property Order.customer.account_type.
  • Deprecated property vat_number of class CustomerBase in favor of new property company_information.vat_number.
  • Deprecated property addresses_are_identical of class FraudFields in favor of new property Order.shipping.address_indicator.
  • Deprecated property card_owner_address of class FraudFields, which should be the same as existing property Order.customer.billing_address.
  • Deprecated property default_form_fill of class FraudFields in favor of new property Order.customer.device.default_form_fill.
  • Deprecated property device_fingerprint_activated of class FraudFields with no replacement.
  • Deprecated property device_fingerprint_transaction_id of class FraudFields in favor of new property Order.customer.device.device_fingerprint_transaction_id.
  • Deprecated property has_forgotten_pwd of class FraudFields in favor of new property Order.customer.account.has_forgotten_password.
  • Deprecated property has_password of class FraudFields in favor of new property Order.customer.account.has_password.
  • Deprecated property is_previous_customer of class FraudFields in favor of new property Order.customer.is_previous_customer.
  • Deprecated property ship_comments of class FraudFields in favor of new property Order.shipping.comments.
  • Deprecated property shipment_tracking_number of class FraudFields in favor of new property Order.shipping.tracking_number.
  • Deprecated property shipping_details of class FraudFields with no replacement.
  • Deprecated property website of class FraudFields in favor of new property Merchant.website_url.
  • Deprecated class FraudFieldsShippingDetails with no replacement.
  • Deprecated property recurring_payment_sequence_indicator of class AbstractCardPaymentMethodSpecificInput in favor of new property recurring.recurring_payment_sequence_indicator.
  • Deprecated property skip_authentication of class AbstractCardPaymentMethodSpecificInput in favor of new property threeDSecure.skip_authentication of its child classes.
  • Deprecated property unscheduled_card_on_file_indicator of class AbstractCardPaymentMethodSpecificInput in favor of new property unscheduled_card_on_file_sequence_indicator.
  • Deprecated property external_cardholder_authentication_data of class CardPaymentMethodSpecificInput in favor of new property three_d_secure.external_cardholder_authentication_data.
  • Deprecated property return_url of class CardPaymentMethodSpecificInput in favor of new property three_d_secure.redirection_data.return_url.
  • Deprecated property payment_product1503_specific_input of class CashPaymentMethodSpecificInput and class CashPaymentProduct1503SpecificInput, since Boleto Bancario no longer uses redirects.
  • Deprecated property shipping_address of class Customer in favor of new property Order.shipping.address.
  • Deprecated property seller of class Order in favor of new property Merchant.seller.
  • Deprecated property return_url of class RedirectPaymentMethodSpecificInput in favor of new property redirection_data.return_url.
  • Deprecated property shipping_address of class CustomerRiskAssessment in favor of new property OrderRiskAssessment.shipping.address.

2.33.0

• Added:
  • Added property shipping to class Order.
  • Added property contact_phone to class PaymentProduct840CustomerAccount.
  • Added method privacypolicy to class ServicesClient.

2.32.0

• Added:
  • Added method cancel to class DisputesClient.

2.31.0

• Added:
  • Added property payment_product840_specific_input to class RedirectPaymentMethodSpecificInputBase.
  • Added class AbstractRedirectPaymentProduct840SpecificInput with property address_selection_at_pay_pal.
  • Added methods dispute and disputes to class PaymentsClient and method disputes to class MerchantClient to handle disputes.
• Changed:
  • Class RedirectPaymentProduct840SpecificInput now extends new class AbstractRedirectPaymentProduct840SpecificInput.

2.30.0

• Added:
  • Added property mobile_payment_method_specific_input to class CreateHostedCheckoutRequest.
  • Added properties pan and payment_method to class DecryptedPaymentData.
  • Added property is_java_script_required to class PaymentProduct.
  • Added property gateway to class PaymentProduct320SpecificData.
  • Added property existing_unique_mandate_reference to classes SepaDirectDebitPaymentProduct771SpecificInput and SepaDirectDebitPaymentProduct771SpecificInputBase.
• Deprecated:
  • Deprecated property mandate_reference of class AbstractSepaDirectDebitPaymentProduct771SpecificInput in favor of the new existing_unique_mandate_reference property of its sub classes.
• Removed:
  • Removed property payment_product320_specific_input from class MobilePaymentMethodSpecificInput. This was only used for Android Pay if you decrypted Google's payment data yourself. Now that Android Pay has been replaced by Google Pay this field is no longer needed.
  • Removed property transaction_id from class MobilePaymentMethodSpecificInput. This was only used for Android Pay and Apple Pay if you decrypted Google's or Apple's payment data yourself. This field was never used, and has therefore been dropped.

2.29.0

• Added:
  • Added property fraugster to class CardFraudResults.

2.28.0

• Added:
  • Added property payment_product3201_specific_output to class RedirectPaymentMethodSpecificOutput.