Details
On this tab you set the basic behaviour of your profile. Try to choose a name which is descriptive of what the purpose of the profile is. Over the next sections we'll address the type of profiles and how they work.
Basic Profile
A basic profile is for use in scenarios that may not require complex web development to start taking transactions. Perfect for when you just need to take transactions with the app, QR code or sending someone a payment link.
For the basic profile type you have access to the following fields:
Field | Description |
---|---|
Name | This is your name for what the profile means to you. |
Profile Type | Choose an Advanced or Basic profile. |
Require email | Whether the customer needs to provide an email when transacting. If they provide an email we will send them a transaction receipt to that email address. |
Ask for Email After Successful Payment | Customers can optionally provide their email at the end of a transaction to receive an email receipt. |
Skip Payment Review | Customers will not see the extra step when making payment that reviews the transaction, unless their input is required. |
Ask For Customer Name After Successful Payment | Customers will be given the option to provide their name after they have made payment. |
Active | Whether the profile is active and allowed to transact. |
Advanced Profile
An advanced profile will enable extra functionality to enable development using callback URLs using the fumopay API. Depending on your business case, you can choose a behaviour that suits your development needs; choose from redirect or inline.
For the advanced profile type you have access to the following fields:
Field | Description |
---|---|
Name | This is your name for what the profile means to you. |
Profile Type | Choose an Advanced or Basic profile. |
Require email | Whether the customer needs to provide an email when transacting. If they provide an email we will send them a transaction receipt to that email address. |
Skip Payment Review | Customers will not see the extra step when making payment that reviews the transaction, unless their input is required. |
Active | Whether the profile is active and allowed to transact. |
Redirect vs Inline
When the profile is set to redirect then the user needs to be redirected to the URL provided by fumo on creation of the transaction. For inline the transaction will need to be captured on the same page. Your development team will need to make sure they implement the webhook and/or the events API endpoints.
There are three URL fields and two for inline. Their purposes are:
Field | Purpose | Behaviour |
---|---|---|
Web Hook URL | This is the URL that will be called once the payment instruction has been placed between the user's account and your account. This happens separate from any user sessions. We will also call this endpoint if a transaction expires. More here | Redirect/Inline |
Success URL | For a redirect profile this is the URL where the user will be redirected once payment has been captured successfully. | Redirect |
Success URL | For inline we will present a return to business button which is useful when working with deep/universal links. | Inline |
Error URL | This is where a user is redirected when an error happens during the payment process. | Redirect |
Transaction Email Settings
When taking a payment from a customer, fumopay offers a given profile the ability to capture a customer's email address so that a receipt can be sent out to the customer. To ensure a business has control of this email journey, there is a set of options that can be configured to require an email before payment, not require an email at all, or requesting that the customer optionally provides an email after the payment is successful.
Require Email = TRUE
When this flag is set to true (as pictured), a customer will have to provide an email address (along with other required details such as the bank and the amount) in order to be able to complete the payment. Once the payment is marked as complete, an email will be sent to the customer.
Require Email = FALSE and Profile Type = ADVANCED
When a profile is advanced, it is likely being used to interface with fumopay's API, or to capture the payment step in an e-commerce journey. By setting the require email flag to false, a customer will be able to complete a payment without needing to provide an email. This is ideal for situations where a customer may not need a fumopay receipt due to the e-commerce process providing the receipt instead.
Require Email = FALSE and Profile Type = BASIC and Ask For Email After Successful Payment = FALSE
When a profile is basic and require email is set to false, an extra flag is now available to configure, called "Ask For Email After Successful Payment". When this is set to false, this means that the business does not require the customer to provide an email when taking a payment, which also means that the customer will not receive a receipt on successful payment. Even if this flag is set to false, if the business has a sales email set, then they will still receive a copy of the receipt.
Require Email = FALSE and Profile Type = BASIC and Ask For Email After Successful Payment = TRUE
When a profile is basic and require email is set to false, an extra flag is now available to configure, called "Ask For Email After Successful Payment". When this is set to true, this means that the business does not require the customer to provide an email when taking a payment. However, once the payment is complete, an email field appears, allowing a customer to optionally provide their email address, should they wish to receive a receipt. Regardless of whether the customer chooses to have their receipt emailed or not, as long as the business has a sales email set, they will always receive a copy of the receipt.
Transaction Settings
In addition to transactional emails there are additional options for skipping payment review screens and asking for a customers name after a successful payment.
Profile Type = BASIC and Ask for Customer Name After Successful Payment = TRUE
Asking customers to input their name after a successful payment is available on the basic profile only. When this flag is set to true (as pictured), a customer will be able to provide their name in text field once the payment has successfully completed.
Skip Payment Review = TRUE
When this flag is set to true (as pictured), a customer will not be shown the payment review screen in the payment journey whenever possible, unless additional input is required from the customer.