[
{
"title":"Testing",
"link":"https://docs.solidgate.com/payments/testing/",
"text":"Simulate payments to test your integration before launching in production.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-customizable.svg"
}
,
{
"title":"Create your payment form",
"link":"https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form/",
"text":"Understand how to integrate the payment form into your product.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-payments.svg"
}
,
{
"title":"Subscriptions",
"link":"https://docs.solidgate.com/subscriptions/",
"text":"Create and maintain a stable and healthy business subscription model.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-global.svg"
}
]
Discover new features and product enhancements for a better experience
An external changelog provides with essential updates on features, security, compliance, and interface changes, helping them stay informed about developments affecting their use of the product.
It aids in understanding the implications of these changes for business operations and in planning any necessary adaptations in systems or processes.
Solidgate API Reference also includes its own changelog, documenting updates specifically for API functionalities.
2024
October
Testing
PayPal
Guide
PayPal testing allows you to simulate failed transactions using a sandbox environment, which is useful for ensuring that your system correctly handles various scenarios, including negative flows.
sandbox testing
now supports simulating failed transactions, helping ensure your system correctly handles negative flows such as insufficient funds, card blocks, and invalid card tokens.
Payment form
Added cardBrandIconStyle field in the
Guide
Efficiently integrate a resign payment form with saved card details.
Resign Form
, enabling customization of card brand icon appearance to improve visual consistency and user experience.
Enhanced the CardMessage
Guide
Form events are essential checkpoints for monitoring user interactions in payments.
event
, allowing for a more individual approach to payment and optimized transaction processing depending on the card type.
Updated
Guide
Our payment form supports recent versions of Chrome Mobile, Safari, and Samsung Browser on mobile, requires TLS 1.2 on all browsers, and may not perform reliably with in-app browsers or certain browser extensions.
supported browsers
list and clarified support limitations, including considerations for in-app browsers and extensions.
Payment link
Enabled the
Guide
You can create and customize payment links using the API or HUB by providing transaction details, adjusting the appearance, and managing options such as editing, duplicating, or deleting links as needed.
management
of Payment Link as a reusable solution directly through the HUB, eliminating the need for code and streamlining setup for non-technical users.
Finance
Introduced
Guide
Strengthen the financial clarity with settlements and settlement reports.
settlement
functionality and settlement reports, enhancing reconciliation processes and enabling more efficient data analysis for financial operations.
HUB
Added the Solidgate
Guide
Optimize your product and payment management with the Solidgate HUB.
HUB
overview for informed management of business operations.
Subscriptions
Extended the list of
Guide
Explore Solidgate subscriptions for seamless recurring customer payments.
statuses
and
Guide
Harness the power of subscription webhooks for efficient subscription status monitoring.
webhooks
to effectively track subscription states and make data-driven decisions to optimize subscription-based revenue.
Added:
possibility to
Guide
Empower your global business by managing fixed indirect taxes.
apply tax profiles to products
via API for convenient product management
a new endpoint for
Guide
Customize product pricing and streamline payment processing with multi-currency and easy editing.
retrieving product details
by product ID
Compliance
Added a
Guide
Navigate the banking landscape with business integrity checklist and best practices.
business integrity checklist
to ensure best practices for smooth acquiring and corporate bank account opening.
September
Payment form
Empowered Payment Form with:
Ability to process
Guide
Optimize your payment form with Apple Pay integration, providing a secure and efficient checkout for Apple device users.
Apple Pay payments in non-Safari
browsers using the new integrationType parameter, expanding payment options for a seamless checkout experience.
paymentDetails
Guide
Form events are essential checkpoints for monitoring user interactions in payments.
event
, which informs merchants of updates or changes to payment details, including price, taxes, and other relevant information, enabling comprehensive tracking of user actions through generated events.
Finance
Updated the
Guide
Streamline tax management for your international business operations with Solidgate.
Taxes
section and introduced a solution for handling
Guide
Empower your global business by managing fixed indirect taxes in Solidgate HUB.
fixed indirect taxes
. It is designed to help adapt to various tax jurisdictions, making it easier for businesses operating in multiple regions to stay compliant with local tax laws while maintaining efficient operations.
Card payments
Added moto type for payments
Guide
Boost transaction success and customer satisfaction by enabling CVV-free payments.
without requiring CVV
input.
Expanded the
Guide
Use zero-amount authorizations to verify cards and store details for future transactions.
zero-amount authorization
flow to support both Google Pay and Apple Pay requests.
Alternative payments
Removed Sofort from available
Guide
Explore and benefit from the most suitable alternative payment methods.
APMs
, impacting all integration options where it was previously available.
Subscriptions
Updated the
Guide
Explore the Solidgate free subscription trial options.
free trial options
for subscriptions by adding a zero-amount authorization for a smooth start to the trial period.
Revised error descriptions and recommendations for
Guide
This error indicates an issue with the customer’s subscription, which can happen for various reasons. For instance, it occurs if the customer already has an active subscription for that product.
2.14 Subscription error
.
Risks
Added PayPal
Guide
Learn how to conveniently provide evidence via Solidgate HUB.
dispute representment
to Solidgate HUB, allowing direct submission of evidence for PayPal review.
Reporting
Added filter criteria to the
subscriptions report
API
to get data based on updated_at and created_at values for efficient data retrieval.
August
Payment form
Added a condition, advising against creating multiple
Guide
Activate and customize the PayPal button on your payment form to ensure a smooth and reliable customer experience.
PayPal buttons
with the same order_id using both host-to-host requests and the payment form simultaneously.
Card payments
Updated the
Guide
Settlement intervals based on payment type and card scheme limits ensure that settlements can be made without a separate request.
settlement terms
with information about handling PSPs settlement limit by comparing it with the settle_interval to ensure a smooth settlement process.
Revised error descriptions and recommendations for
Guide
This error indicates that the next subscription or a 1-click payment using a recurring token via this card is not allowed.
3.11 Recurring payment
cancelled and
Guide
This error indicates an issue with the transaction amount, which may be incorrect or exceed allowable limits.
2.02 Invalid amount
.
Alternative payments
Added
Guide
Open banking streamlines real-time, direct bank payments across Europe.
Open banking
country-specific visual assets for download to enhance the checkout experience across different regions.
Subscriptions
Implemented the
Guide
Employ coupons to customize subscription discounts.
coupon code
import for efficient management and distribution of promo codes at scale, saving time and supporting marketing campaigns to drive customer engagement and sales.
Added options to
Guide
Enabled managing subscription pauses with flexible start and end points, ensuring smooth transitions between active and paused statuses.
pause the subscription
immediately and infinitely, providing a flexible alternative to setting a specific start date or avoiding full cancellation, which enhances customer satisfaction and retention.
Reporting
Added filtering filter criteria to the
Guide
Detailed transaction insights for APMs with customer data.
APM orders
and
Guide
Comprehensive insights for managing PayPal disputes and optimizing resolution processes.
PayPal disputes
reports, and included the legal_entity field in
Guide
Financial entries report offers crucial data for reconciliations and reporting.
financial reports
, enhancing report unloading and data analysis.
July
Payment form
Enhanced Payment Form with a
Guide
Activate and customize the PayPal button on your payment form to ensure a smooth and reliable customer experience.
PayPal button
for streamlined checkout, featuring faster button rendering and the ability to display the PayPal option through a parameter during intent initialization.
Updated
Guide
Simulate payments to test your integration before launching in production.
test
cards for declining orders for recurring and recurring auth transactions, and general 0.01 error codes.
Card payments
Updated the retry limit to 120 attempts for resign, void, settle, and refund operations, enhancing the quality of the
Guide
Accept and manage payments from your customers.
payment processing
.
Alternative payments
Implemented
Guide
Open banking streamlines real-time, direct bank payments across Europe.
Open banking
as an additional payment method for EU customers.
Empowered PayPal integration with:
Extension of the
Guide
Activate and customize the PayPal button on your payment form to ensure a smooth and reliable customer experience.
PayPal button
post-initialization period to 7 days, improving payment flexibility and potentially increasing conversion rates by allowing customers more time to complete transactions.
A dynamic descriptor for
Guide
PayPal provides a global online payment platform.
PayPal
for enhanced user payment recognition and enabling better transaction matching with alerts, potentially reducing disputes and chargebacks.
Subscriptions
Implemented subscription payment attempt limit for subscription first payments, restricting the number of invoices in the processing state to a maximum of 3 for identical customer_account_id and product_id combinations. This limit improves first-sale conversion rates and allows payment flexibility while effectively managing orders in the processing state.
Risks
Updated the
Guide
Effectively managing PayPal disputes and chargebacks.
PayPal risk metrics
page for streamlined handling of internal disputes, claims, and external chargebacks, along with best practices for fraud prevention and maintaining healthy dispute ratios.
Reporting
Added the
Guide
Automate indirect tax compliance on all your transactions using Solidgate.
US taxes
page, introducing automated US indirect tax compliance through Avalara and Vertex partnerships, streamlining tax management across various transaction types and providing automated receipt generation.
Updated the flow image with the list of all fields that can be returned for
Guide
Boleto Bancário enhances online shopping in Brazil by offering a flexible voucher payment method.
Boleto
,
Guide
Efecty expands access to e-commerce in Colombia with a large number of cash acceptance points.
Efecty
,
Guide
OXXO vouchers enhance Mexico's payment landscape.
OXXO
,
Guide
Sencillito streamlines payments in Chile with its cash payment system.
Sencillito
,
and
Guide
Servipag provides universal payment solutions in Chile.
Servipag
.
Subscriptions
Added information that an
Guide
Product archiving is a convenient approach to maintaining an organized and clutter-free view of your current product catalog, making it easier to manage and update active products.
archived product
can be duplicated to create a new offer.
Guide
Subscription restoration resumes a cancelled subscription with the billing period adjusted based on the defined expiration date.
Restore subscription
page is updated to include information about verifying existing subscriptions with the same customer_account_id and product_id combination and checking if the subscription is already being processed to avoid duplicates and unwanted charges.
May
Payment form
Extended the list of
Guide
Payment Form can be automatically translated to the customer's preferred language, enhancing the overall checkout experience and improving conversion rates.
supported translations
with el, hr, hu, sk, sr, ur for reaching a broader global customer base.
Payment page
Extended the list of:
Guide
The Payment Page adapts automatically based on the configuration to enhance the checkout experience, ensuring clarity and ease of use.
supported translations
with da, fr, sv, fi, el, no for reaching a broader global customer base, which also applies to
Payment Link
API
alternative payments with
Guide
BLIK streamlines online payments in Poland, enabling direct bank account transactions.
Blik
and
Guide
MB WAY enhances digital payments in Portugal.
MB WAY
to increase conversion rates in respective markets
Implemented an additional field rule, india_zip field, for entering the Indian ZIP code. It matches its usage on the
Guide
Similar to the Payment Form, the Payment Page can have the necessary additional fields. This enables dynamically displaying relevant fields based on the customer's location, improving data collection accuracy and providing a tailored checkout experience.
Payment Form
.
Alternative payments
Implemented
Guide
Cash App Pay lets customers make online and in-app purchases with the stored funds or with their linked credit and debit cards or bank account.
Cash App Pay
, a US digital wallet to expand payment options for the US customers.
Subscriptions
Improved:
the calculation for the next charge date after the
Guide
During the redemption period when failed subscription payments occur, Solidgate calculates the next charge date and retries the invoice collection with optimized intervals, ensuring proper billing cycles.
redemption period
, ensuring accurate billing and positive customer experience
the
Guide
The trial price can be set in the smallest currency unit that allows creating attractive trial offers and promotions to increase customer acquisition and engagement.
trial price
setting in the smallest currency unit
Implemented the
Guide
Product archiving eases active product management while preserving historical records of discontinued offerings for easy reference.
Archive product
feature in the new HUB version for enhanced product catalog management.
April
Payment form
Integrated PayPal SDK into the
Payment Form
SDK
as a payment button, with simulated transport for collecting payments and a callback for processing payments; also updated the
Guide
Efficiently integrate a resign payment form with saved card details.
Resign Form
SDK.
Implemented:
an
Guide
Solidgate Payment Form will check the Card BIN and receive a list of necessary additional fields according to information about the BIN country (the first 6 digits).
additional field
rule, india_zip field, for entering the Indian ZIP code
the display of logos of more brands, cardbrands field, on the form
Card payments
Updated the
Guide
Auto-settle is a feature that automatically settles orders if you provide a settle_interval value in your charge requests with the type auth.
auto-settle
logic description and expanded the validation rule for settle_interval.
Alternative payments
Removed M-Pesa (Africa) from available
Guide
Connect alternative payment methods to boost your checkout conversion. Solidgate offers diverse payment methods, aiding merchants in understanding and catering to local preferences globally.
payment methods
.
March
Improved a detailed
Guide
Simulate payments to test your integration before launching in production.
testing guide
for pre-launch integration, including sandbox testing, scenario simulations, and error handling.
Added:
Guide
Specific IP addresses are used for outbound requests to external services for secure and effective communication.
outgoing request tracking for IP addresses
to enhance network security and monitoring
Guide
The payment failed due to a technical issue on the provider’s or processor’s side.
6.03 processing issue
error code, advising to retry the payment or use an alternative card
a subscription flow to the
Guide
Efficiently integrate a resign payment form with saved card details.
resign payment form
, requiring product_price_id for product pricing and customer_account_id for customer identification
Payment page
Enhanced the Payment Page
Guide
The language of the information on the payment page is determined by: language parameter passed; browser language, if no parameter.
translations
by adding Romanian ro, further supporting our global user base and improving accessibility for Romanian-speaking customers.
February
Payment form
Implementation of CPF brazil_cpf validation improves payment accuracy by enabling users to correct entered data before submission.
Introduced type validation for the Payment Form FormParams to ensure data integrity and accurate form submissions.
Updated the cardholder name card_holder validation regular expression to
^\w.{2,50}\w$
for both the payment form and payment page, enhancing accuracy in user input.
Added:
Guide
Payment Form is optimized for secure environments and is not suitable for embedding within merchant’s iframes or on HTTP web pages.
Iframe and HTTP Limitations
, detailing the constraints for embedding the Payment Form in iframes and on HTTP pages, particularly affecting Apple Pay and Google Pay transactions
Guide
These insights help merchants understand common issues and optimize their strategies for successful resign transactions, enhancing customer experience and potentially boosting conversion rates.
error insights
, explaining common errors in resign transactions and their impact on success rates and customer experience
Implemented a feature to notify users about potential
Guide
This process is designed to enable secure and reliable payment processing through the use of 3D Secure (3DS) with challenge authentication flow.
3D Secure verification
on the Payment Form, preventing misconceptions of form unresponsiveness.
Payment page
Added
Guide
Additional information about the payment page.
page insights
, providing comprehensive guidance on creating a Solidgate payment page and generating
Guide
After creating the Solidgate Payment Page, the subsequent step involves generating a QR code, enabling customers to easily initiate payments.
QR codes
, essential for enhancing payment experiences, especially on smart TVs.
Alternative payments
Implemented
Guide
Unified Payments Interface (UPI), India's premier payment solution, boasts high transaction success rates.
UPI
as a new payment method that supports seamless transactions in India with the possibility of refunds and certain transaction limits.
Added details on
Guide
This overview assists merchants in seamlessly integrating payment solutions for the Indian market, addressing crucial aspects like status delays, transaction limits, decline reasons, and specific payment flows.
India-specific integration requirements
for payments, covering status delays, transaction limits, decline reasons, and payment flows for cards and UPI.
Subscriptions
Updated
Guide
This cancel code occurs when customers revoke their billing token by contacting customer support side or on PayPal’s.
cancel code 8.11
to reflect the specifics of declining recurring payments when receiving
Guide
Merchant Advice Codes (MACs) are introduced by Mastercard to clearly communicate to merchants the reason for declining transactions, and the course of action that merchants can take.
MACs
such as 3 and 21.
The
Guide
This feature prevents subscription interruptions, whether triggered by card-related issues or a desire to switch to an alternative payment source.
update subscription token
feature has been added, ensuring seamless subscription management and reducing payment disruptions.
Implemented the return
Guide
This cancel code is used when a decline occurs on a recurring payment, and retries during the redemption period have been activated but were unsuccessful, resulting in the automatic cancellation of the customer’s subscription.
cancel code 2.09
to indicate an invalid expiration date when the card linked to a token has expired, ensuring accurate payment processing.
Enhanced the API Reference by allowing the
creation
API
and
update
API
of product prices with a maximum value, and enabling a settle interval settle_interval of
0
for flexible scheduling.
HUB
Added a geo_country filter to the Hub dashboard to enable user location-based analytics.
Updated the Sign Up form to allow the entry of Instagram/Facebook handles in the designated field, enhancing social media connectivity.
January
Payment form
Made the IP field ip_address optional to accommodate a wider range of use cases.
Added Hebrew he to
Guide
If your preferred language is not listed, our payment button will be displayed in English by default.
supported
translations.
Card payments
Updated recommendations related to decline reasons in versions
Guide
Card is expired.
2.09
Invalid expiration date and
Guide
An error occurred and the token was not found.
7.01
Card token not found.
2023
December
Payment form
Added examples for encrypting paymentIntent for form generation
Guide
An alternative option for integrating the payment form exists without utilizing the Solidgate SDK.
without SDK
in
Node.js
,
Go
,
PHP
,
Python
,
Kotlin
,
C#
,
Ruby
, and
Java
.
Both geo_country and platform
Guide
To initiate a charge, supply transaction-specific information through paymentIntent fields.
request parameters
are now optional.
The partialIntent
Guide
After forming the merchant data and converting it to a plain object, use it in front-end code to update with the partialIntent encrypted String.
object includes
the capability to update Order metadata, enhancing business process efficiency.
Guide
To initiate a charge, supply transaction-specific information through paymentIntent fields.
Implemented
character limit validation for the customer_email field, restricting it to a maximum of 100 characters.
Payment link
Guide
A Payment Link is a URL that takes customers directly to a unique payment page to complete a payment. You can quickly and easily create a Payment Link URL and embed it or share it via email.
Payment Links
now support both one-time and recurring subscription payments, with the creation process streamlined through Solidgate’s Postman collection.
Card payments
Added:
external_mpi_data to APIs for improved third-party 3D Secure authentication handling
merchant_advice_code in the system for clearer communication regarding declined transactions and actionable merchant advice
separate fields for customer_phone_country_code and phone number in all requests
Implemented a detailed explanation of the
Guide
This process is designed to enable secure and reliable payment processing through the use of 3D Secure (3DS) with challenge authentication flow.
frictionless flow
in 3D Secure processes.
Alternative payments
Integrated
Guide
Przelewy24 is a leading online payment method in Poland, offering a variety of payment options like bank transfers, credit cards, and e-wallets.
Przelewy24
and
Guide
BLIK streamlines online transactions in Poland by offering a secure and efficient mobile payment method, enabling customers to easily pay for goods and services directly from their bank accounts.
Blik
to expand payment options, specifically enhancing services for the Polish market.
Subscriptions
Added order_data to the
subscription
Webhookinvoices object for expanded data management.
November
Payment form
Added support for zero amount transactions on the
Guide
This guide simplifies the process of adding the Solidgate Payment Form to your website. It covers the preparation of the back end, SDK installation, API instance creation, and merchant data setup.
payment form
to accommodate specific use cases.
Implemented a convenient
Guide
Efficiently integrate a resign payment form with saved card details.
resign payment form
that allows customers to streamline their payment process by securely storing a token for future use, reducing the need for additional input during subsequent payments.
Updated the Payment Form validation for an empty string (processing as null for enhanced data handling).
Payment page
Expanded the
Payment Page request
API
to include product_price_id as a parameter for initializing the payment page, catering to more diverse business needs.
Added zero amount support for payments via payment page to accommodate specific use cases.
Card payments
Improved response handling to provide a 200 status code with validation error details when encountering validation errors during external API communication.
Alternative payments
Expanded business operations by implementing:
Guide
MB WAY is a widely adopted digital wallet in Portugal, favored for mobile payments.
MB WAY
Guide
Davivienda is a key financial institution in Colombia, renowned for its extensive online banking services.
Davivienda
Guide
Efecty is a vital cash payment method for online purchases in Colombia, specially designed for users without bank accounts or credit cards.
Efecty
Guide
PSE is a leading online bank transfer solution in Colombia, supported by 20 different banks, offering a direct and efficient payment method ideal for the Colombian e-commerce sector.
PSE
Guide
Sencillito is a leading cash payment method in Chile, known for its ease of use and quick processing.
Sencillito
Guide
Servipag is a leading payment platform in Chile, renowned for its versatility in both online and offline transactions.
Servipag
Guide
Webpay is Chile's leading online payment service, operated by Transbank.
Webpay
Implemented streamlined
Guide
The PayPal billing agreement streamlines the checkout experience by enabling 1-click purchases and upsells on the merchant’s site.
PayPal billing agreement
that enables one-click purchases, upsells, and automatic billing for subscription models, providing a seamless checkout experience for both customers and merchants.
Fixed country validation in
recurring
API
processes to comply with ISO standards.
Subscriptions
Improved
Guide
Employ coupons to customize subscription discounts.
coupon
functionality, enabling the creation of unique coupon codes associated with an account and providing clarity.
Expanded functionality with new
Guide
For all changes to the subscription, merchants get asynchronous notifications via subscription, similar to payments.
webhook
events for managing subscription pause schedules:
subscription.pause_schedule.create
subscription.pause_schedule.update
and subscription.pause_schedule.delete, enhancing business process automation