Highlights
2411.00.00
REST API
- Any returnUrl property only allows the https: protocol, domain names and intent URLs (for redirecting to a mobile application). IP addresses and localhost are not supported.
2410.00.00
REST API
- Adjusted the displayOrder returned in GET /v1/{merchantId}/products and GET /v1/{merchantId}/products/{paymentProductId} API calls for countryCode:TH.
- The fields order.customer.personalInformation.name.firstName and order.customer.personalInformation.name.surname are no longer required for Brazilian payments (conditional validation still applies, see API Reference)
MyCheckout Hosted Payment Pages
- Added validation on Brazilian fiscal number on the MyCheckout hosted payment pages.
- When creating a Brazilian payment, the firstName and surname fields are no longer shown when using a 14 digit Fiscal Number (CNPJ).
- When creating a Brazilian payment, the first name, surname, and company name fields are properly validated based on their conditional requirements (see API Reference) when JavaScript is disabled.
- The payment product ordering for the payment product selection page is changed for the following countries: Thailand.
Webhooks
- errors.id property is now returned in webhooks for payment engine errors. It gives more insights on the reason a payment has been declined.
2409.00.00
REST API
- The property order.additionalInput.typeInformation.paymentCode can now be used to set the to support Account Funding Transactions.
- A new property order.customer.companyInformation.dateOfIncorporation is added to the Create Payment and Hosted Checkout requests. Number of properties were made required in the Create Payment and Hosted checkout requests for cross-border and/or airline merchants.
- /payments/{paymentId}/authenticationresult endpoint for in-app 3DSv2.
- New merchant action INITIALIZE_INAPP_THREED_SECURE_SDK when using in-app 3DSv2. Initialization parameters for in-app 3DSv2 are returned on merchantAction.inAppThreeDSecureSdk.initializationParameters.
Other
-
Configuration Center pre-production and production URLs to Worldline URL in the top bar
-
Sandbox signup URL and Insights URL to Worldline URL in the top bar
Webhooks
- We added the X-GCS-Signature header to the activate webhook endpoint request. You can use this header to verify if the request comes from Worldline.
2408.00.00
REST API
- The property paymentOutput.cardPaymentMethodSpecificOutput.card.cardNumber is now added to the payment response.
2407.00.00
REST API
- Removed payment product Giropay with paymentProductId 816.
Other
- Kuwaiti Dinar is now supported for dynamic 3D Secure.
2406.00.00
Other
Added
In the Configuration Center you can now adjust the order of payment products. This order is shown to your consumers on the payment product selection page of the MyCheckout hosted payment pages and is also returned in the displayOrder property of the GET payment product(s) API call.
2405.00.00
REST API
Added
- The property payment.paymentOutput.cardPaymentMethodSpecificOutput.networkTokenUsed has been added to the payment response to indicate if a network token was during the payment.
- A new property order.shipping.shippedFromZip is added to the Create Payment and Create Hosted Checkout request.
- A new property order.shoppingCart.items.orderLineDetails.naicsCommodityCode is added to the Create Payment and Create Hosted Checkout request.
Fixed
- Resolved an issue where the getProduct and getProducts API calls did not return false for the property canBeIframed for paymentProductId 865, and 8590 - 8597.
MyCheckout Hosted Payment Pages
Fixed
- Resolved an issue that caused the dropdowns in the header (e.g. currency selection) to become unresponsive for a subset of ~merchantId~s with specific configuration.
Other
Fixed
- Fixed an issue that prevented users from uploading Apple Pay certificates. Users can now successfully upload their Apple Pay certificate without any errors.
Webhooks
Added
- The property payment.paymentOutput.cardPaymentMethodSpecificOutput.networkTokenUsed has been added to the payment response to indicate if a network token was during the payment.
2404.00.00
REST API
Changed
-
The property order.customer.fiscalNumber can now dynamically be made optional on the Create Payment API with a feature toggle.
- Fixed an issue for which now one error will be returned in the response in case an invalid Brazilian fiscal number is provided in the request.
- Adjusted the displayOrder returned in GET /v1/{merchantId}/products and GET /v1/{merchantId}/products/{paymentProductId} API calls for countryCodes: AR, AU, BR, CA, CN, FR, DE, IN, JP, MX, NL, KR, TR, UK, US to give products a higher priority depending on the country.
MyCheckout Hosted Payment Pages
Changed
- The payment product ordering for the payment product selection page is changed for the default order and for the following countries: Argentina, Australia, Brazil, Canada, France, Germany, India, Japan, Mexico, Netherlands, Mexico, South Korea, Turkey, Unites States, United Kingdom.
Webhooks
Fixed
- The payment status CAPTURED is now returned if a payment webhook event is sent with a final partial capture.
Other
Changed
2403.00.00
REST API
Added
-
The properties city, houseNumber, street, and zip in the property order.additionalInput.accountFundingRecipent.address. are now made optional on the hosted checkout and create payment request.
Fixed
-
Fixed an issue with recurring payments for which cvv is not present.
-
Proper 400 error message will be returned when merchantId is not provided in the request.
2402.00.00
REST API
Added
- Added isInstallments query parameter for the Get Payment Product(s) and Get Payment Product Group(s) endpoints.
Changed
- When creating a payment for Brazil using a order.customer.fiscalNumber from a legal entity, the property order.customer.personalInformation is no longer required.
- Improved the validation on Brazilian fiscal numbers.
MyCheckout Hosted Payment Pages
Fixed
- The configured business name will now be displayed in the Apple Pay payment sheet unless provided in the hosted checkout request.
Other
Changed
- Pop-up texts for Payment Products Ordering page.
2401.00.00
REST API
Added
- It is now possible to create UCOF payments by presenting card details.
-
New funding types fundingGiftCardForPersonalUse and fundingGiftCardForSomeoneElse added to order.additionalInput.typeInformation.fundingType.
-
New account number type giftCard added to order.additionalInput.accountFundingRecipient.accountNumberType.
-
New funding type storedValueDigitalWallet added to order.additionalInput.typeInformation.fundingType.
Changed
- The payment product Pix (ID 6105) no longer requires the properties street, houseNumber, city, stateCode, and zipCode to be present in the property order.customer.billingAddress.
- The order.customer.device object is now made optional on the hosted checkout request.
Fixed
-
Modified the API documentation to change the title from Get installment info to Get installment information.
-
The payment product Pix (ID 6105) no longer requires the property phoneNumber or mobilePhoneNumber to be present in the property order.customer.contactDetails.
- The payment products MercadoPago (ID 6106) and PicPay (ID 6107) no longer require the properties order.customer.contactDetails.phoneNumber or order.customer.contactDetails.mobilePhoneNumber.
-
Required fields for OXXO payment product in Mexico changed to only firstName, lastName, and email.
-
Required fields for OXXO Pay payment product in Mexico changed to only firstName, lastName, and email.
-
Required fields for PicPay payment product in Brazil changed to only firstName, lastName, email, and iscalNumber.
-
Required fields for Mercado Pago payment product in Argentina, Brazil and Mexico changed to only firstName, lastName, and email with fiscalNumber as an additional requirement for Argentina and Brazil.
-
Resolved a problem where the HTTP status code 404 was incorrectly returned instead of 400 when the error code 'PARAMETERNOTFOUNDINREQUEST.
-
The original error message from WL Online Payment Platform is now returned in the error message.
-
The correct error is now returned if the property order.customer.fiscalNumber is invalid when creating a payment.
Other
Added
-
Updated the webhooks page to include a note that there can be a delay of up to 10 minutes from the time an endpoint is added until it becomes active.
Fixed
-
Fixed an issue where users were unable to download CSRs on the Apple Pay page.
-
Fixed the "Contact us" link on the dashboard page and a few existing typos.
2312.00.00
REST API
Added:
- Added a new property cardPaymentMethodSpecificInput.acquirerPromotionCode to POST/v1/{merchantId}/payments and POST/v1/{merchantId}/hostedcheckouts API calls.
Changed:
- Included new endpoint URLs and description text.
MyCheckout Hosted Payment Pages
Fixed:
- Total amount for the payment page is used in MyCheckout hosted payment page editor.
- The fiscalNumber property is now made visible on the MyCheckout hosted payment pages for OXXO Pay and Mercado Pago.
2311.00.00
REST API
Added:
- The property fraudResults.microsoftFraudProtection has been added to the payment response.
- The property isAuthenticationSupported has been added to the PaymentProduct object. This property indicates if the payment product supports 3D Secure.
Changed:
- Adjusted the displayOrder returned in GET /v1/{merchantId}/products and GET /v1/{merchantId}/products/{paymentProductId} API calls for countryCode to give debit products a higher priority.
- The property cardPaymentMethodSpecificInput.threeDSecure.sdkData.deviceInfo is removed.
Fixed:
- If a card is co-branded, we now return the correct payment product ID.
MyCheckout Hosted Payment Pages
Added:
- Added the option to customize the subscription details for the MyCheckout hosted payment pages.
Changed:
- The payment product ordering for the payment product selection page is changed for Finland as new Finland regulations require a non-credit product to be shown as the first payment product to a consumer.
2310.00.00
REST API
Added
- fundingType property to order.additionalInput.typeInformation
- order.additionaInput.accountFundingRecipient property with name, address, accountNumber, accountNumberType, dateOfBirth and partialPan
- firstName and surname properties to order.additionaInput.accountFundingRecipient.name
- additionalInfo, city, stateCode, state, countryCode, houseNumber, street and zip properties to order.additionalInput.accountFundingRecipient.address
- order.customer.personalInformation.identification property with idType, idValue and idIssuingCountry
- isCompany property to order.customer
- The property redirectPaymentMethodSpecificInput.paymentProduct809SpecificInput.issuerId is no longer required when the merchant is configured to use iDEAL 2.0
- The complete payment endpoint can now be used for completing 3D Secure payments.
- Mapped error code 33000833 to HTTP status 400 INVALID_VALUE.
- canBeIframed flag for PP 843 (gateway & domain) is added
Fixed
Fixed validation of the following fields for the hosted checkout request:
- fraudFields.customerIpAddress
- fraudFields.orderTimezone
- merchant.websiteUrl
- order.customer.device.ipAddress
- order.customer.device.locale
- order.customer.device.timeZoneOffsetUTCMinutes
- order.customer.device.userAgent
- order.shoppingCart.items.invoiceData.description
- order.shoppingCart.items.orderLineDetails.productName
- The merchant property is now made visible on the CreateHostedCheckoutRequest.
- The property KeyValuePair.value is now returned even when the value is null.
Deprecated
- Deprecated property order.additionalInput.loanRecipient with no replacement.
MyCheckout Hosted Payment Pages
Added
- Added the option to customize the subscription details for the MyCheckout hosted payment pages
Fixed
- Payment products where not updated when changing between different currencies.
- Payment products without instructions are now not being shown in the editor.
Other
- The file extension of the language packs is changed to xlsx.