The following sections are general information required for using the Flute API suite.
Flute provides different environments to run endpoints.
Sandbox
The sandbox environment is for development and testing. No payments, charges, or invoices will be enforced. It is a fully isolated account that mirrors production behavior.
It is used to validate your integration before going live. You will work with your Flute support team developing workflows and tools.
baseURL: https://sandbox.api.flute.com
Production
The production environment is for deploying the payment system live to clients. All payments, charges, or invoices are live and will be enforced.
When your product is ready to be deployed live, the Flute support team will work with you to ensure compliance. This compliance follows the production readiness checklist. It ensures the best and optimal developer, client, and customer experience.
For more information and details about the production readiness checklist, see Production Go-Live Guide.
baseURL: https://api.flute.com
Using the baseURL
Use the baseURL instead of the placeholder noted in each endpoint. For example, an endpoint may be described in the endpoint documentation as:
GET {{baseURL}}/v2/customers
To make this call in the sandbox environment, use:
POST https://sandbox.api.flute.com/v2/customers
To make this call in the production environment, use:
POST https://api.flute.com/v2/customers
- The customer completes their shopping experience on the merchant's website by selecting the products or services. They navigate to the checkout page on the merchant's website.
- They enter their personal and payment information. This could include card details, or net banking information.
- The merchant's website captures these details, formatting the details as needed to conform to Flute payment gateway requirements.
- This sensitive data is transmitted by a secure connection (HTTPS) to the Flute payment gateway. The Flute payment gateway is a service that makes authorization and sale by cards or ACH (automated clearing house, an electronic network used by financial institutions to process direct deposits).
- Upon receiving this information, the Flute payment gateway further routes this payment data to the processing center, such as TSYS.
- This entity communicates with the customer's bank to get authorization or denial for the payment. The processing center determines if the payment is approved, that is, if there are sufficient funds or credit available in the customer's account.
- After the transaction is processed, the processing center sends back a response to the Flute payment gateway. This response includes details of the transaction, such as whether it was approved or declined.
- The Flute payment gateway relays this information back to the merchant's website.
- The merchant's website receives this information and displays a message or signal for the customer. Depending on whether the transaction was approved or declined, the appropriate message is displayed to the customer. For instance:
If transaction was successful, a confirmation message is shown, usually with a transaction ID and other details.
If it was declined, the customer is informed and typically asked to try another payment method.
- Diners Club: Card numbers are typically 14 or 16 digits long.
- Discover: Card numbers are typically 16 digits long.
- JCB: Card numbers are typically 16 digits long.
- MasterCard: Card numbers are typically 16 digits long.
- VISA: Card numbers are typically 13 or 16 digits long.
Account Holder Types
| id | name |
|---|---|
| 1 | Business |
| 2 | Personal |
Account Types
| id | name |
|---|---|
| 1 | Checking |
| 2 | Savings |
Business Categories
| id | name |
|---|---|
| 1 | WebDeveloper |
| 2 | IndependentSoftwareVendor |
| 3 | IndependentSalesOrganization |
Transaction Creator Types
| id | name |
|---|---|
| 1 | Portal |
| 2 | ApiToken |
| 3 | Terminal |
| 4 | Invoice |
| 5 | QuickPayment |
| 6 | WebComponent |
| 7 | Subscription |
| 8 | MobileApp |
| 9 | TapToPay |
Partner Statuses
| id | name |
|---|---|
| 1 | Active |
| 2 | Suspended |
Partner Business Model Types
| id | name |
|---|---|
| 1 | SingleAffiliateModel |
| 2 | SubAffiliateModel |
Payment Method Types
| id | name |
|---|---|
| 1 | Card |
| 2 | ElectronicCheck |
Payment Processor Statuses
| id | name |
|---|---|
| 1 | Active |
| 2 | Inactive |
Payment Processor Types
| id | name |
|---|---|
| 1 | TSYS |
| 2 | EFT |
Payment Session Statuses
| id | name |
|---|---|
| 1 | Created |
| 2 | Cancelled |
| 3 | Completed |
| 4 | Failed |
Transaction Statuses
| Status Code | Status | Description | Available actions |
|---|---|---|---|
| 1 | Authorized | Transaction status after an approved pre-authorization request | Capture, Void |
| 2 | Captured | Transaction status after approved sale or capture request | Void |
| 3 | Voided | Transaction status after merchant voids an authorized request or refunds a captured (not settled) request | N/A |
| 4 | Refunded | Transaction status after merchant refunds a settled request | N/A |
| 5 | Verified | NA | N/A |
| 6 | Settled | Transaction status after successful settlement request. All captured transactions should have status changed to settled | Refund |
| 7 | Partially Authorized | Transaction status after an approved pre-authorization request with the approved amount less than initially requested. Indicates that the issuer bank has approved only a portion of the requested payment amount. The exact authorized amount should be checked in the corresponding field. | Capture, Void |
| 8 | Informational | NA | N/A |
| 21 | Scheduled | NA | N/A |
| 24 | Pending | Transaction status while changing status. This is a temporary status | N/A |
| 91 | Declined | Transaction status after a denied pre-authorization, sale or capture request | N/A |
| 92 | Failed | Transaction status after a failure at any type of request | N/A |
| 92 | Expired | Transaction status after 7 days in authorized status (merchant has not captured within this time) | N/A |