2.0.0

• Added:
  • Added method UploadFile to struct disputes.Client and method Files to struct merchant.Client to support uploading and downloading of files for disputes.
  • Added support for binary requests and responses:
    • Added interface communicator.BodyHandler that can be used to process binary response bodies.
    • Added interface communication.ResponseHandler that can be used to process binary responses.
    • Added structs communication.UploadableFile and communication.MultipartFormDataObject and interface communicator.MultipartFormDataRequest for sending multipart/form-data requests.
    • Refactored struct communicator.Communicator. It has new GetWithHandler, DeleteWithHandler, PostWithHandler and PutWithHandler methods that take a communicator.BodyHandler instead of a response object. The Post, PostWithHandler, Put and PutWithHandler methods have special support for objects of types communication.MultipartFormDataObject and communicator.MultipartFormDataRequest.
    • Refactored interface communicator.Connection. Its methods no longer return a communication.Response object but instead take a communication.ResponseHandler response handler. It also has new PostMultipart and PutMultipart methods that take a communication.MultipartFormDataObject.
    • Added method UnmarshalFromReader to interface communicator.Marshaller.
    • Added method SetBinaryContentBody to structs logging.RequestLogMessageBuilder and logging.ResponseLogMessageBuilder to support logging binary content.
  • Added the following methods to type communication.Headers:
    • GetHeader returns a single header (or nil).
    • GetHeaderValue returns a single header value (or an empty string).
    • GetDispositionFilename returns the filename of the Content-Disposition header (or an empty string).
• Removed:
  • Removed method PublicKey from struct products.Client, and struct publickey.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 several structs for domain classes that were generated but never used. In other SDKs these existed only as base classes for other classes, but Go does not support this and therefore these structs served no purpose.
  • Removed method communicator.AddRequestParameter. Generated communicator.ParamRequest implementations directly create the communicator.RequestParam objects instead of calling this method.
  • Removed struct communication.Response in favor of streaming responses.
  • Removed struct communication.Request, which was only used internally.
  • Removed method Response of struct errors.ResponseError.

---

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 communicator.Connection, you need to change the implementation of the Get, Delete, Post and Put methods. These now take a ResponseHandler instead of returning a Response object. You also need to implement the new PostMultipart and PutMultipart methods. You probably also should take care to not log any binary request or response bodies.
• If you have created your own implementation of communicator.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 methods that take a BodyHandler.
• If you have created your own implementation of communicator.Marshaller you need to implement the new UnmarshalFromReader method.

1.35.0

• Added:
  • Added properties PaymentProduct1521SpecificInput, PaymentProduct1522SpecificInput, PaymentProduct1523SpecificInput, PaymentProduct1524SpecificInput and PaymentProduct1526SpecificInput to struct payment.CashPaymentMethodSpecificInput.
• Fixed:
  • Removed invalid SDK data information from the create payment request example.

1.34.0

• Added:
  • Added property ThirdPartyData to struct payment.MerchantAction.
  • Added property PaymentProduct861SpecificInput to struct payment.RedirectPaymentMethodSpecificInput.
  • Added property OpenID to struct payment.RedirectPaymentProduct863SpecificInput.
  • Added property HostedCheckoutId to structs payments.FindParams and refunds.FindParams.

1.33.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 VatNumber to struct definitions.CompanyInformation.
  • Added property Merchant to structs hostedcheckout.CreateRequest, payment.CompletePaymentRequest, payment.CreateRequest, riskassessments.RiskAssessment, riskassessments.RiskAssessmentBankAccount and riskassessments.RiskAssessmentCard.
  • Added properties Recurring and UnscheduledCardOnFileSequenceIndicator to structs payment.AbstractCardPaymentMethodSpecificInput, payment.CardPaymentMethodSpecificInput and payment.CardPaymentMethodSpecificInputBase.
  • Added property ThreeDSecure to structs payment.CardPaymentMethodSpecificInput and payment.CardPaymentMethodSpecificInputBase.
  • Added properties MobilePhoneNumber and WorkPhoneNumber to struct payment.ContactDetails.
  • Added properties Account, AccountType, Device and IsPreviousCustomer to struct payment.Customer.
  • Added properties DirectoryServerTransactionId, ThreeDSecureVersion and ThreeDServerTransactionId to struct payment.ExternalCardholderAuthenticationData.
  • Added property MobileThreeDSecureChallengeParameters to struct payment.MerchantAction.
  • Added property Customer to struct payment.OrderApprovePayment.
  • Added property TransactionType to struct payment.OrderTypeInformation.
  • Added property RedirectionData to struct payment.RedirectPaymentMethodSpecificInput.
  • Added properties Address, AddressIndicator, Comments, FirstUsageDate, IsFirstUsage, TrackingNumber and Type to struct payment.Shipping.
  • Added properties GiftCardPurchase, IsPreOrder, PreOrderItemAvailabilityDate and ReOrderIndicator to struct payment.ShoppingCart.
  • Added properties DirectoryServerTransactionId, SdkData, ThreeDSecureData, ThreeDSecureVersion and ThreeDServerTransactionId to struct payment.ThreeDSecureResults.
  • Added properties Account, AccountType, Device and IsPreviousCustomer to struct riskassessments.CustomerRiskAssessment.
  • Added property Shipping to struct riskassessments.OrderRiskAssessment.
• Deprecated:
  • Deprecated property IsRegisteredCustomer of struct definitions.AirlineData in favor of new property payment.Order.Customer.AccountType.
  • Deprecated property VatNumber of structs definitions.CustomerBase, payment.Customer and token.CustomerToken in favor of new property definitions.CompanyInformation.VatNumber.
  • Deprecated property AddressesAreIdentical of struct definitions.FraudFields in favor of new property payment.Order.Shipping.AddressIndicator.
  • Deprecated property CardOwnerAddress of struct definitions.FraudFields, which should be the same as existing property payment.Order.Customer.BillingAddress.
  • Deprecated property DefaultFormFill of struct definitions.FraudFields in favor of new property payment.Order.Customer.Device.DefaultFormFill.
  • Deprecated property DeviceFingerprintActivated of struct definitions.FraudFields with no replacement.
  • Deprecated property DeviceFingerprintTransactionId of struct definitions.FraudFields in favor of new property payment.Order.Customer.Device.DeviceFingerprintTransactionId.
  • Deprecated property HasForgottenPwd of struct definitions.FraudFields in favor of new property payment.Order.Customer.Account.HasForgottenPassword.
  • Deprecated property HasPassword of struct definitions.FraudFields in favor of new property payment.Order.Customer.Account.HasPassword.
  • Deprecated property IsPreviousCustomer of struct definitions.FraudFields in favor of new property payment.Order.Customer.IsPreviousCustomer.
  • Deprecated property ShipComments of struct definitions.FraudFields in favor of new property payment.Order.Shipping.Comments.
  • Deprecated property ShipmentTrackingNumber of struct definitions.FraudFields in favor of new property payment.Order.Shipping.TrackingNumber.
  • Deprecated property ShippingDetails of struct definitions.FraudFields with no replacement.
  • Deprecated property Website of struct definitions.FraudFields in favor of new property payment.Merchant.WebsiteUrl.
  • Deprecated struct definitions.FraudFieldsShippingDetails with no replacement.
  • Deprecated property RecurringPaymentSequenceIndicator of structs payment.AbstractCardPaymentMethodSpecificInput, payment.CardPaymentMethodSpecificInput and payment.CardPaymentMethodSpecificInputBase in favor of new property Recurring.RecurringPaymentSequenceIndicator.
  • Deprecated property SkipAuthentication of struct payment.AbstractCardPaymentMethodSpecificInput with no replacement.
  • Deprecated property SkipAuthentication of structs payment.CardPaymentMethodSpecificInput and payment.CardPaymentMethodSpecificInputBase in favor of new property ThreeDSecure.SkipAuthentication of its child structs.
  • Deprecated property UnscheduledCardOnFileIndicator of structs payment.AbstractCardPaymentMethodSpecificInput, payment.CardPaymentMethodSpecificInput and payment.CardPaymentMethodSpecificInputBase in favor of new property UnscheduledCardOnFileSequenceIndicator.
  • Deprecated property ExternalCardholderAuthenticationData of struct payment.CardPaymentMethodSpecificInput in favor of new property ThreeDSecure.ExternalCardholderAuthenticationData.
  • Deprecated property ReturnUrl of struct payment.CardPaymentMethodSpecificInput in favor of new property ThreeDSecure.RedirectionData.ReturnUrl.
  • Deprecated property PaymentProduct1503SpecificInput of struct payment.CashPaymentMethodSpecificInput and struct payment.CashPaymentProduct1503SpecificInput, since Boleto Bancario no longer uses redirects.
  • Deprecated property ShippingAddress of struct payment.Customer in favor of new property payment.Order.Shipping.Address.
  • Deprecated property Seller of struct payment.Order in favor of new property payment.Merchant.Seller.
  • Deprecated property ReturnUrl of struct payment.RedirectPaymentMethodSpecificInput in favor of new property RedirectionData.ReturnUrl.
  • Deprecated property ShippingAddress of struct riskassessments.CustomerRiskAssessment in favor of new property riskassessments.OrderRiskAssessment.Shipping.Address.

1.32.0

• Added:
  • Added property Shipping to struct payment.Order.
  • Added property ContactPhone to struct payment.Product840CustomerAccount.
  • Added method Privacypolicy to struct services.Client.

1.31.0

• Added:
  • Added method Cancel to struct disputes.Client.

1.30.0

• Added:
  • Added property PaymentProduct840SpecificInput to struct payment.RedirectPaymentMethodSpecificInputBase.
  • Added property AddressSelectionAtPayPal to struct payment.RedirectPaymentProduct840SpecificInput.
  • Added methods Dispute and Disputes to struct payments.Client and method Disputes to struct merchant.Client to handle disputes.

1.29.0

• Added:
  • Added property MobilePaymentMethodSpecificInput to struct hostedcheckout.CreateRequest.
  • Added properties Pan and PaymentMethod to struct payment.DecryptedPaymentData.
  • Added property IsJavaScriptRequired to structs product.PaymentProduct and product.PaymentProductResponse.
  • Added property Gateway to struct product.PaymentProduct320SpecificData.
  • Added property ExistingUniqueMandateReference to structs payment.SepaDirectDebitPaymentProduct771SpecificInput and payment.SepaDirectDebitPaymentProduct771SpecificInputBase.
• Changed:
  • Use minimal TLS version 1.2 for PCI DSS compliance.
• Deprecated:
  • Deprecated property MandateReference of structs payment.AbstractSepaDirectDebitPaymentProduct771SpecificInput, payment.SepaDirectDebitPaymentProduct771SpecificInput and payment.SepaDirectDebitPaymentProduct771SpecificInputBase in favor of the new ExistingUniqueMandateReference property of the latter two.
• Removed:
  • Removed property PaymentProduct320SpecificInput from struct payment.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 TransactionId from struct payment.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.
• Fixed:
  • Fixed an index out of range error when using UTF-8 runes while logging is enabled.

1.28.0

• Added:
  • Added property Fraugster to struct definitions.CardFraudResults.

1.27.0

• Added:
  • Added property PaymentProduct3201SpecificOutput to struct payment.RedirectPaymentMethodSpecificOutput.