> ## Documentation Index
> Fetch the complete documentation index at: https://primer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Fintecture Immediate Transfer via Direct Integration
> Let customers securely make payments using Fintecture Immediate Transfer on your website or mobile application via Primer's direct integration.
export const TxnTag = ({status}) => {
const getStyles = status => {
const baseStyle = {
display: 'inline-block',
padding: '4px 8px',
borderRadius: '4px',
fontSize: '13px',
fontWeight: '400'
};
switch (status) {
case "PENDING":
return {
...baseStyle,
backgroundColor: '#ececec',
color: '#9f9f9f'
};
case "AUTHORIZED":
return {
...baseStyle,
backgroundColor: '#ecfdf5',
color: '#047857'
};
case "SETTLED":
case "PARTIALLY_SETTLED":
return {
...baseStyle,
backgroundColor: '#ecfdf5',
color: '#047857'
};
case "DECLINED":
case "FAILED":
return {
...baseStyle,
backgroundColor: '#fef2f2',
color: '#dc2626'
};
case "CANCELLED":
return {
...baseStyle,
backgroundColor: '#fefce8',
color: '#d78203'
};
case "SETTLING":
return {
...baseStyle,
backgroundColor: '#e0f2fe',
color: '#0c4a6e'
};
default:
return {
...baseStyle,
backgroundColor: '#f3f4f6',
color: '#374151'
};
}
};
return {status};
};
## Get started with Fintecture Immediate Transfer
### Before you begin
If this is your first payment method, make sure to follow the [Get started guide](/get-started/overview) to begin processing payments with Primer.
### Configure in the Dashboard
1. **Add Fintecture Immediate Transfer to your Dashboard**\
Go to the [Connections](/connections/payment-methods) section of the Dashboard and look for `Fintecture Immediate Transfer`.
Follow the instructions to connect your Fintecture account to your Primer Dashboard.
2. **Activate Fintecture Immediate Transfer on the Checkout**\
Go to the [Checkout](/checkout) section of the Dashboard and activate the Fintecture Immediate Transfer payment method.
3. **Configure a Workflow to process payments made with Fintecture Immediate Transfer**\
Go to [Workflows](/workflows), and ensure there is a workflow with the **Authorization** action configured to process APMs. There is no need to add **Capture** as this payment method goes straight to from . Finish the workflow with a **Continue payment flow** action.
#### Note: Expiring payments
By default, Primer automatically requests Fintecture to expire any abandoned payments within 30 days. You can adjust this duration by using [Advanced Metadata Mapping](/payment-services/advanced-metadata-mapper) to override the `meta.expiry` field. Note that the field is in seconds, with a minimum value of 1 and maximum value of 99999999 seconds.
### Prepare the client session
Fintecture Immediate Transfer leverages the following parameters to process a payment.
Pass them when creating the client session.
| Parameter Name | Required | Description |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [currencyCode](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-currency-code) | ✓ | 3-letter currency code in ISO 4217 format, e.g. EUR. Currently, only EUR is supported. |
| [order](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-order.)
↳ [lineItems](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-order-line-items) | | For each line item in the order, the following fields must all be present to be sent to Fintecture:
• `order.lineItems[].name`
• `order.lineItems[].quantity`
• `order.lineItems[].amount`
• `order.lineItems[].itemId`
If any of these fields are missing for any line item, none of the line items will be included in the Fintecture request. Fintecture requires that either all specified fields for all line items are sent together or none at all. |
| [customer](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer)
↳ [billingAddress](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer-billing-address)
↳ [firstName](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer-billing-address-first-name) | | `firstName` will be used in `meta` -> `psu_name` in the request to Fintecture |
| [customer](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer)
↳ [billingAddress](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer-billing-address)
↳ [lastName](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer-billing-address-last-name) | | `lastName` will be used in `meta` -> `psu_name` in the request to Fintecture |
| [customer](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer)
↳ [emailAddress](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer-email-address) | | `emailAddress` will be used in `meta` -> `psu_email` in the request to Fintecture |
| [customer](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer)
↳ [phoneNumber](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer-mobile-number) | | `phoneNumber` will be sent in `meta` -> `psu_phone` in the request to Fintecture |
| [customer](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer)
↳ [billingAddress](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer-billing-address) | | The following address fields must all be present to be sent to Fintecture:
• `customer.billingAddress.street`
• `customer.billingAddress.city`
• `customer.billingAddress.postalCode`
• `customer.billingAddress.countryCode`
If any of these fields are missing, none of them will be included in the Fintecture request. Fintecture requires that either all of these fields are sent together or none at all. Additionally, if all the required fields are present, the field `customer.billingAddress.addressLine1` will also be included in the request if it is provided. |
| [customer](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer)
↳ [deliveryAddress](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-customer-shipping-address) | | The following address fields must all be present to be sent to Fintecture:
• `customer.deliveryAddress.street`
• `customer.deliveryAddress.city`
• `customer.deliveryAddress.postalCode`
• `customer.deliveryAddress.countryCode`
If any of these fields are missing, none of them will be included in the Fintecture request. Fintecture requires that either all of these fields are sent together or none at all. Additionally, if all the required fields are present, the field `customer.deliveryAddress.addressLine1` will also be included in the request if it is provided. |
| [metadata](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-metadata) | | Using [Advanced Metadata Mapping](/payment-services/advanced-metadata-mapper), you can set up metadata field mappings between your request and Fintecture or override existing fields. For example, `meta.expiry` can be overridden to adjust how quickly abandoned payments should expire. The default now is 30 days. Please make sure to specify the duration in seconds. |
## Add Fintecture Immediate Transfer into your website or mobile app
Use our customizable drop-in UI to quickly add payment methods to your checkout.
Have the freedom to build your own UI using our headless checkout.