This page notes the additions and updates made to Finix. For changes to the Finix API and how to update your API version, see Versioning.
Upgraded Dashboard Date Selection Button
We’ve upgraded the look and feel of the date selection button that appears throughout the Finix dashboard, to make filtering your dashboard payments data by specific dates or periods more seamless and dynamic.
Prevent Duplicate Refunds Using an
You can now include an
idempotency_id when creating a Refund or Reversal. Including this unique identifier with your refund API requests helps ensure that even if duplicate API requests for the same refund are sent, the refund is only initiated once. This is key, because sometimes an issue like an interruption with your network connection or problem with your server can cause an API request for the same refund to get submitted multiple times.
For more details on the
idempotency_id, see Idempotency Requests.
Validate and Tokenize Bank Accounts at the Same Time
You can now validate new bank accounts when they’re tokenized and used to create payment instruments. This helps you know for certain whether a new bank account is valid before using it in a transaction.
To verify that a bank account actually exists when creating a token, you can include the
attempt_bank_account_validation_check field. If a bank account doesn’t exist, the token will create a
payment_instrument with an error in the
- For details on how to tokenize the details of a bank account, see Using Hosted Fields .
- For details on how to create a Payment Instrument using a token, see Create a Payment Instrument .
Edit Buyer Names for Payment Instruments via API
The name of a buyer linked to a payment instrument (card, bank account, token, etc.) can now be edited via API. This is helpful in situations where you need to change a name to correct an error or reflect an update to the name of the payment instrument’s owner.
To update the name associated with a
Payment Instrument, see Update a Payment Instrument.
Apply for Live Payment Processing via the Finix Sandbox
You can now apply for a live payment processing account in the Finix Sandbox!
The Finix Sandbox allows you to easily sign up for an account via our website to explore the Finix dashboard and simulate what your live production experience would be - including accepting test payment transactions, simulating merchant payouts, and building test integrations with Finix.
If you’re ready to start processing payments with Finix, you can easily apply for a live account via your sandbox dashboard, by submitting all the needed application info and selecting what pricing schema and business configuration works best for you. If approved, you can begin accepting payments with Finix in live production.
More Failure Codes for Processing In-Person Payments
Below, we’ve added two additional in-person payment failure codes to help you better understand why a certain transaction failed and trigger your own workflows in response to the issue. You can see the full list of failure codes and associated failure messages here.
- DEVICE_IN_USE : The device is currently processing a request. Attempt a request again once the request is complete, or within 6 minutes.
- DEVICE_NOT_ENABLED : The device is not activated. Please activate the device and try again.
We also updated the failure messages for the following existing in-person payment failure codes:
- GENERIC_DECLINE : The transaction was declined for an unknown reason. The account owner needs to contact their issuer for more information.
- TRANSACTION_NOT_PERMITTED : The transaction was declined because the card or transaction type is not permitted. The cardholder needs to use a different type of card or attempt a different transaction method.
Faster in-person payments
In-person payments are now faster than ever! We’ve improved the time it takes our in-person payments API to share the result of a transaction with your system to an average speed of 0.5 seconds. This helps speed up the overall transaction flow and deliver more seamless checkout experiences for your buyers.
To make your dashboard experience more intuitive and powerful, we’ve added the Onboarding Form webhook event to dashboard and Updated API + Webhook logs.
Payment Solutions for Individual Businesses and Online Marketplaces
Finix’s payment platform can now support Individual Businesses and Online Marketplaces, in addition to our existing customer segments.
This release delivers more configurations of our platform and different bundles of features for payments solutions tailored to the unique needs of different supported business models and their specific payments use cases.
- Individual Businesses : eCommerce and other individual businesses who sell goods and services directly to buyers online, in-person, or both.
- Software Platforms : SaaS companies offering embedded payments to their customers online, in-person, or both.
- Online Marketplaces : Digital marketplaces that connect buyers and sellers online.
- Payfacs : Large enterprise organizations registered as payment facilitators.
For more info, see Who We Serve.
Customized Developer Sandboxes for Different Business Types
We’ve enhanced the Finix Sandbox to provide tailored testing experiences for different types of businesses. This latest release adds specialized sandbox environments for different business types, including Software Platforms, Online Marketplaces and Individual Businesses. Now, when a user signs up for a Sandbox account, they will select their business type and be taken to a Finix Sandbox dashboard designed specifically for the business type they selected.
The Finix Sandbox allows users to easily sign up for an account via our website and explore the Finix dashboard and simulate what their live production experience would be - including accepting test payment transactions, simulating merchant payouts, and building test integrations with Finix, all before applying for a live production account.
For more info, see Signing up for a Finix Account.
Updated Finix Team Members & Roles in the Finix Dashboard
This feature enables customers to manage their Team Members, Roles, and access levels in the Finix dashboard. These enhancements make it possible for administrators (those with the highest level of access) to add, customize, and manage the users from their company, directly in the Finix dashboard. Managed permissions provide enhanced security and limit who can see sensitive payments data.
In the Finix dashboard you can now easily:
- Add and deactivate team members
- Assign different permission-based roles
- Create custom roles to address unique business needs
The variety of configurable profiles to choose from include:
- Payment Operations Manager
- Merchant Manager
- Settlement Specialist
- User Management Admin
- Custom Roles
Customers can seamlessly manage which team members have access to their company’s dashboard and their specific permissions, deactivate users who no longer need access, as well as create new custom roles tailored to their unique user requirements.
A common example of a custom role you might create is for an outside accountant, who may need access to specific data for a set amount of time during the year. Start managing your team’s roles and permissions here.
Webhook Event Logs
From the developer section of the dashboard, users can now review logs that detail all the webhook events they’ve received. Developers are also able to receive dashboard and email notifications about webhook events they’ve received.
With an easily accessible log you can check at any time, it’s an easier path to debug, troubleshoot, and audit the activity you process.
The webhook events log allows you to:
- Review how webhooks are configured
- Review a history of all webhook event attempts
- Filter webhooks by attempts and troubleshoot any failed events
- Reattempt events that have failed
- Enable email and in-dashboard notifications for failing webhooks
Save Time & API Calls with an Added
Merchant Field to
Now that we’ve added the
merchant field to
Authorizations, you can save multiple API calls by directly referencing a
Merchant resource instead of using the Seller’s
Identity to reach it. This is especially helpful when you’re looking to understand the origin of a transaction.
More Dispute Functionality Available in the Finix Sandbox
In the Finix Sandbox, users submitting and accepting disputes will now receive an API response that echoes the Dispute resource. Previously, they’d only receive a return indicating that their API call was accepted and that the dispute exists. This update allows Sandbox users to better simulate disputes with more of the same functionalities they’d experience with a live payment processing account, like seeing the status of a dispute (“Won", “Closed” and “In Progress”), as well as other information.
For more details, see Responding to Disputes.
Improved Search Functionalities - Find the info you need more easily
Customers now have the ability to search for tags in the dashboard.
You can now search the following resources by the keys and values of any tags that have been applied:
Customers can also search for tags in the Finix API using our new tag filters, allowing you to enable more functionality with our system and the ability to link your own system’s IDs with Finix.
We've also made general improvements to the logic around our search! You can type partial words or terms and we’ll return all results that include that partial search term.
Max Transaction Limit on ACH
Using our API, customers can set a different maximum transaction limit for ACH Direct Debits than the maximum set for Credit Card transactions. This gives you flexibility with ACH Direct Debits and allows you to create a maximum transaction limit specifically for ACH transactions.
For more details see the
Android Mobile Tokenization
Android Tokenization enables you to accept and tokenize payment details in your Android app without exposing yourselves to PCI risk.
This completes the rollout of our tokenization offerings, which now includes: web, iOS, and Android.
Test ACH Returns in Sandbox
You can now test ACH Returns in your sandbox! This enables you to test scenarios, process failure reasons, and help your sellers understand how to handle failed ACH payments–all in a test environment. Tests include:
- Insufficient Funds
- Account is Closed
- No account on file
- Invalid Account Number
For more details, see Testing ACH Returns.
December 15, 2022
This is the last of a three-part release to refresh the user experience of our entire dashboard. The additional user experience improvements include reorganizing the Application, Merchant, and Push-to-Card pages to simplify where to find the most helpful information and make finding that information more intuitive. The changes made to the dashboard the past three weeks should help you complete tasks more quickly and efficiently–for example, by using new filters to easily create on-demand reports for information you’re seeking, or using the click-to-copy function to accurately and efficiently transfer data to external databases.
For more information about what's available in the Finix Dashboard, see Finix Dashboard.
November 17, 2022
New Dashboard Designs, Embedded Onboarding Forms, & Payout Settings
Thanks to the collective feedback from our customers about the Finix Dashboard, every page of the Finix Dashboard has been redesigned, focusing specifically on how content is organized, utilized by different teams (such as features catered to developers and to payment operations), and laid out for greater clarity, discoverability, and ease of use. This release kicked off the implementation of those designs.
We’ve updated naming conventions to be more intuitive, for instance: “Transfers” that are buyer purchases are now called “Payments” in the dashboard. Payments now appear along with “Authorizations” and “Refunds” in the “Transactions” list in the left navigation bar of your dashboard.
We’ve better organized pages within each section of the dashboard, and added more filters so you can easily sort and report on information you want to see at any given time. These filters are also helpful to pull on-demand reports from the dashboard so that you don’t need to wait for settlement reports, which come at the end of the day and include comprehensive information, which may not be needed if your goal is to extract a finite set of information from a given time period. These reports can be found in your exports section of the dashboard–at the bottom left–so you can go back and reference them at any time. You can also download them as a CSV file.
Lastly, we improved the settlements experience with detailed page headers that showcase the payout type of a given transaction (such as net versus gross payout type).
We released an entirely new suite of payment terminals for
including the addition of new Finix Mobile SDKs and new Finix APIs so that you can choose the software and hardware pairing that works best for your business.
You can now white label using your own branding with Finix!
- You can now white-label, or customize your dashboard, your merchants’ dashboards, and embedded merchant onboarding forms using your own company branding - including your company logo and colors.
- White labeling creates a consistent user experience for your merchants which can lead to increased trust and translate to a higher willingness to complete onboarding more quickly.