---
title: "Finateco Card Processing"
slug: "finateco"
updated: 2026-02-27T07:55:38Z
published: 2026-02-27T07:55:38Z
canonical: "docs.apcopay.com/finateco"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apcopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Finateco Card Processing

## Supported Transaction Types

- [ ] Authorisation `AUTH`
- [ ] Capture `CAPT`
- [x] Purchase `PURC`
- [ ] Refund `PARTIALREFUND`
- [ ] Void `GENERALVOID`
- [ ] Payouts `ORIGINALCREDIT`
- [ ] Recurring `PURC`

## Integrations Supported

**Deposit - Purchase**

- [x] Hosted Payment Page
- [x] Direct Connect ( server-to-server)

**Capture, Refunds, Payouts**

- [ ] Hosted Payment Page
- [ ] Direct Connect ( server-to-server)

## Supported Wallet

- [x] GooglePay
- [x] Applepay

## Currencies & Countries Supported

| Title | Description |
| --- | --- |
| **Currencies Supported** | Most major currencies |

## Additional attributes to process Deposits

You must include the following JSON Attributes in the payload.

If you are using our **Hosted Payment Page**

| Description | Hosted Payment Page |
| --- | --- |
| **Transaction Type** | "TransactionType": "PURC" |
| **Force Transaction Routing** | "Routing": { "ForceBank": "FT" |
| **Client Details** | "Client" : { "Email": "[johndoe@gmail.com](mailto:johndoe@gmail.com)", "FirstName" : "John", "LastName" : "Doe", "MobileNo": "+35612345678", "City" : "Mqabba", "IPAddress" : "214.21.134.79", "Country" : "GBR" |
| **Test Indicator** | "isTest”: true |

Sample requests using our Hosted Payment Page can be viewed here.

```json
{
  "TransactionType": "PURC",
  "Currency": "EUR",
  "Amount": "55.3",
  "OrderReference": "FT test",
 "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "FailRedirectionURL": "https://yourURLhere.com/FailRedirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "IsTest": "True",
  "Routing": {
    "ForceBank": "FT"
  },
  "Client" : {
    "Email": "johndoe@gmail.com",
    "FirstName" : "John",
    "LastName" : "Doe",
    "MobileNo": "+35612345678",
    "City" : "Mqabba",
    "IPAddress" : "214.21.134.79",
    "Country" : "GBR"
  }
}
```

If you are using our **direct connect solution** (server-to-server)

| Description | Direct Connect |
| --- | --- |
| **Transaction Type** | "TransactionType": "PURC" |
| **Force Transaction Routing** | "Routing": { "ForceBank": "FT" |
| **Client Details** | "Client" : { "Email": "[apco@test.com](mailto:apco@test.com)", "FirstName" : "Apco", "LastName" : "Test", "MobileNo": "+35612345678", "City" : "Marsa", "IPAddress" : "214.21.134.79" |
| **Card Details** | "PaymentCredentials": { "PaymentSource": "Card", "CardType": "VISA", "CardNumber": 4000001219146651, "CvV2": 123, "ExpMonth": "11", "ExpYear": 2028, "CardHolderName": "frictionless Processed" |
| **Browser details** | "BrowserDetails": { "UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36", "JavaEnabled": true, "ScreenColorDepth": "1", "ScreenWidth": "1080", "ScreenHeight": "840", "TimeZone": "2", "AcceptHeader": "application/json", "BrowserLanguage": "en" } |
| **Test Indicator** | "isTest”: true |

Sample requests using **Direct Connect** can be viewed here.

```json
 {
  "TransactionType": "PURC",
  "Currency": "EUR",
  "Amount": "1.00",
  "OrderReference": "FT test",
  "UniqueReference" : "931cc726-b4c0-4b98-a20e1204",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
    "CallBackURL": "https://www.yourURLhere.com/callback",
  "IsTest": "True",
  "Routing": {
    "ForceBank": "FT"
  },
  "Client" : {
    "Email": "apco@test.com",
    "FirstName" : "Apco",
    "LastName" : "Test",
    "MobileNo": "+35612345678",
    "City" : "Marsa",
    "IPAddress" : "214.21.134.79"
  },
  "BrowserDetails": {
    "UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
    "JavaEnabled": true,
    "ScreenColorDepth": "1",
    "ScreenWidth": "1080",
    "ScreenHeight": "840",
    "TimeZone": "2",
    "AcceptHeader": "application/json",
    "BrowserLanguage": "en"
  },
  "PaymentCredentials" : {
    "PaymentSource" : "Card",
    "CardType" : "VISA",
    "CardNumber" : "4387751111111111",
    "CvV2": "123",
    "ExpMonth": "02",
    "ExpYear": "2026",
    "CardHolderName": "John Doe"
  }
}
```

**Test Credentials**

One must use a future expiry date and use “Frictionless Processed” as the cardholder name, for more test information on different card use cases [here](/v1/docs/test-card-numbers).