Skip to main content
Documentation Powered by Redocly

Partners Public APIs (1.4)

Download OpenAPI specification:Download

API documentation for Fena partners

Companies management

This module will allow you to manage your companies.

Create company

Create company

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
name
required
string

Name of the company

countryCode
required
string

ISO country code where company is registered

industry
string

Scope of the company

type
required
string (CompanyType)
Enum: "solo_trader" "company"
identifier
required
string [ 8 .. 10 ] characters

Company reference number . If company type is solo trader/individual , please put UTR of company owner

"active" (string) or "banned" (string) or "pending_verification" (string) or "started_verification" (string) or "rejected_with_retry_allowed" (string) (CompanyStatus)
publicEmail
required
string

Public email of the company

publicWebsite
string

Public web-site of the company

privacyPolicy
string

Privacy policy of the company

supportPhone
required
string

Support phone of the company

taxNumber
string

Tax number of the company

contactName
required
string

Primary contact

object (BankAccount)
object (CreateIntegrationDuringCompanyCreate)

If bank account was specified , it will be connected to this integration by default

required
object (Address)
object (Address)
sendEmail
required
boolean

Ability to send an email with directors verification links to a specified publicEmail address. Requires email settings at https://partner.fena.co/settings/email

Responses

Request samples

Content type
application/json
{
  • "name": "Fena",
  • "industry": "Health and beauty",
  • "countryCode": "GB",
  • "type": "company",
  • "identifier": "12345678",
  • "publicEmail": "example@mail.com",
  • "contactName": "John Smith",
  • "supportPhone": "+447975777666",
  • "address": {
    },
  • "bankAccount": {
    },
  • "integration": {}
}

Response samples

Content type
application/json; charset=utf-8
{
  • "created": true,
  • "result": {
    }
}

Update company's data

Update company's data

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
tradingName
string

Trading name of the company

"active" (string) or "banned" (string) or "pending_verification" (string) or "started_verification" (string) or "rejected_with_retry_allowed" (string) (CompanyStatus)
industry
string

Scope of the company

publicEmail
string

Public email of the company

publicWebsite
string

Public web-site of the company

privacyPolicy
string

Privacy policy of the company

supportPhone
string

Support phone of the company

taxNumber
string

Tax number of the company

object (Address)

Responses

Request samples

Content type
application/json
{
  • "tradingName": "string",
  • "status": "active",
  • "industry": "string",
  • "publicEmail": "string",
  • "publicWebsite": "string",
  • "privacyPolicy": "string",
  • "supportPhone": "+441234567890",
  • "taxNumber": "string",
  • "tradingAddress": {
    }
}

Response samples

Content type
application/json; charset=utf-8
{
  • "created": true,
  • "result": {
    }
}

Disable company from using service

Disable company from using service

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "updated": true,
  • "result": {
    }
}

Get list of all companies

Get list of all companies

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    ]
}

Get company's data

Get company's data

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    }
}

Bank accounts

This module will allow you to manage a company bank accounts, which can later be used to receive payments.

Create new bank account for a company

Create new bank account for a company

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: multipart/form-data
providerExternalId
required
string

Name of provider. List of available providers can be found here https://docs.fena.co/provider/limitations

externalAccountId
required
string 8 characters ^[0-9]+$

Account number of bank account

identification
required
string 6 characters ^[0-9]+$

Sort code of bank account

name
required
string

Name (alias) of bank account

file
file

Bank statement file. Only the following formats are accepted: .pdf, .png, .gif, .jpg, .doc/docx, .xls/xlsx, .csv, .rtf, .txt

"verified" (string) or "pending" (string) or "disabled" (string) or "manual review required" (string) (BankAccountStatus)

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "created": true,
  • "result": {
    }
}

Edit bank account name

Edit bank account name

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string

ID of the bank account

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
string

Name of bank account

Responses

Request samples

Content type
application/json
"string"

Response samples

Content type
application/json; charset=utf-8
{
  • "created": true,
  • "result": {
    }
}

Get list of company's bank accounts

Get list of company's bank accounts

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    ]
}

Get company's bank account

Get company's bank account

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string

Bank account ID

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    }
}

Get bank account authorization service URL

Get bank account authorization service URL

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{}

Integrations

This module will allow you to manage integrations. Integrations are used to set up custom redirect URL and webhook URL . In order for the integration to work, you need to add a previously created bank account to it, after which this integration can be used when creating payments. When initializing payments, users will be redirected to the specified URL redirect, and payment status data will be sent to the specified webhook.

Get list of company's integrations

Get list of company's integrations

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{}

Get company's integration data

Get company's integration data

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string

Mongoose Object ID of integration

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{}

Create new integration for a company

Create new integration for a company

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
name
required
string

Website / App Name

webhookUrl
required
string

Webhook / Payment Notification URL to which Fena will send payment status updates

bankAccount
required
string

ID of merchant's bank account to which payment will be sent

isSandbox
boolean
fenaPaymentPageRedirectEnabled
boolean
Default: true

Control whether your customer will be redirected to a Fena page before being redirected to your website, specified in the redirect URL, after processing a payment. If set to false, the customer will be redirected directly to your website after processing a payment. If set to true, the customer will be redirected to a Fena page before being redirected to your website.

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json; charset=utf-8
{}

Update existing integration data

Update existing integration data

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string

Mongoose Object ID of integration

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
name
required
string

Website / App Name

webhookUrl
required
string

Webhook / Payment Notification URL to which Fena will send payment status updates

bankAccount
required
string

ID of merchant's bank account to which payment will be sent

isSandbox
boolean
fenaPaymentPageRedirectEnabled
boolean
Default: true

Control whether your customer will be redirected to a Fena page before being redirected to your website, specified in the redirect URL, after processing a payment. If set to false, the customer will be redirected directly to your website after processing a payment. If set to true, the customer will be redirected to a Fena page before being redirected to your website.

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json; charset=utf-8
{}

Payments

This module will allow you to manage company's payments.

Create and process payment

Create and process payment

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
One of
invoiceRefNumber
required
string <= 12 characters ^[a-z0-9-]+$

Reference number of payment

amount
required
string^[0-9]*.[0-9]{2}$

Amount of money to pay

bankAccount
required
string

ID of merchant's bank account to which payment will be sent

customerName
string

The name of the client to whom it will be sent

dueDate
object

Payment request due date. JavaScript Date Object.

customerEmail
string

Specify customer email address if you want to send payment request to the customer

customerEmailCC
Array of strings

Specify email CC addresses along with customer's email address if you want to send payment request to customer's CC

type
string (PaymentTypes)
Enum: "link" "qr" "mobile"

Responses

Request samples

Content type
application/json
Example
{
  • "invoiceRefNumber": "#024",
  • "amount": "123.45",
  • "customerName": "John",
  • "dueDate": "2022-03-26T00:00:00.000Z",
  • "customerEmail": "example@gmail.com",
  • "customerEmailCC": [
    ],
  • "bankAccount": "63630c54c07af6f56cbd959c"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "created": true,
  • "result": {
    }
}

Get payment data

Get payment data

path Parameters
id
required
string

Payment ID

companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    }
}

Get list of all payments

Get list of all payments

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    }
}

Edit payment data

Edit payment data

path Parameters
id
required
string

Payment ID

companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
_id
required
string

Mongoose Object ID

invoiceRefNumber
required
string <= 12 characters ^[a-z0-9-]+$

Reference number of payment

amount
required
string^[0-9]*.[0-9]{2}$

Amount of money to pay

customerName
string

The name of the client to whom it will be sent

dueDate
object

JavaScript Date Object

customerEmail
string

Specify customer email address if you want to send payment request to the customer

customerEmailCC
Array of strings

Specify email CC addresses along with customer's email address if you want to send payment request to customer's CC

customRedirectUrl
string <uri>

Custom redirect URL for the payment to which the user will be redirected after the payment is processed.Takes precedence over the integration's redirect URL. If not provided, the integration's redirect URL will be used.

Responses

Request samples

Content type
application/json
{
  • "invoiceRefNumber": "#024",
  • "amount": "123.45",
  • "customerName": "John",
  • "dueDate": "2022-03-26T00:00:00.000Z",
  • "customerEmail": "example@gmail.com",
  • "customerEmailCC": [
    ]
}

Response samples

Content type
application/json; charset=utf-8
{
  • "saved": true,
  • "result": {
    }
}

Process draft payment

Process draft payment

path Parameters
id
required
string

Payment ID

companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "saved": true,
  • "result": {
    }
}

Cancel payment

Cancel payment

path Parameters
id
required
string

Payment ID

companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "saved": true
}

Refund payment

Refund payment

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string
Example: 62b48c5b6ba2cd6a040b20a8

ID of the payment

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
amount
string

Override refund amount

object

Responses

Request samples

Content type
application/json
{
  • "amount": "string",
  • "payeeAccountInfo": {
    }
}

Response samples

Content type
application/json; charset=utf-8
{
  • "saved": true,
  • "result": {
    }
}

Recurring payments

This module will allow you to manage company's recurring payments.

Create recurring payments

Create recurring payments

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
One of
reference
required
string <= 12 characters ^[a-z0-9-]+$
recurringAmount
required
string^[0-9]*.[0-9]{2}$

The amount of money that will come to your bank account from the client during the active period of regular payments

recurringPaymentDate
required
string

Javascript date. First payment date of recurring payment. Note: Due to banks requirements , the first payment date must be 3 working days in the future.

numberOfPayments
required
integer

Expected number of payments. Set 0 for indefinite

frequency
required
string
Enum: "one_week" "one_month" "three_months" "one_year"

Time interval between payments.

bankAccount
string

ID of the bank account to which the money will be sent

initialPaymentAmount
string^[0-9]*.[0-9]{2}$

Set if you want to request single immediate payment

customerName
string
customerEmail
string

Specify customer email address if you want to send payment request to the customer

customerEmailCC
Array of strings

Specify email CC addresses along with customer's email address if you want to send payment request to customer's CC

Responses

Request samples

Content type
application/json
Example
{
  • "reference": "12345abc",
  • "recurringAmount": "0.50",
  • "recurringPaymentDate": "2022-12-24T00:00:00Z",
  • "numberOfPayments": 0,
  • "frequency": "one_week",
  • "bankAccount": "63eb772c27bfe15a04550cd6",
  • "initialPaymentAmount": "0.50",
  • "customerName": "string",
  • "customerEmail": "string",
  • "customerEmailCC": [
    ]
}

Response samples

Content type
application/json; charset=utf-8
{
  • "created": true,
  • "result": {
    }
}

Save and send recurring payments

Save and send recurring payments

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
One of
reference
required
string <= 12 characters ^[a-z0-9-]+$
recurringAmount
required
string^[0-9]*.[0-9]{2}$

The amount of money that will come to your bank account from the client during the active period of regular payments

recurringPaymentDate
required
string

Javascript date. First payment date of recurring payment. Note: Due to banks requirements , the first payment date must be 3 working days in the future.

numberOfPayments
required
integer

Expected number of payments. Set 0 for indefinite

frequency
required
string
Enum: "one_week" "one_month" "three_months" "one_year"

Time interval between payments.

bankAccount
string

ID of the bank account to which the money will be sent

initialPaymentAmount
string^[0-9]*.[0-9]{2}$

Set if you want to request single immediate payment

customerName
string
customerEmail
string

Specify customer email address if you want to send payment request to the customer

customerEmailCC
Array of strings

Specify email CC addresses along with customer's email address if you want to send payment request to customer's CC

Responses

Request samples

Content type
application/json
Example
{
  • "reference": "12345abc",
  • "recurringAmount": "0.50",
  • "recurringPaymentDate": "2022-12-24T00:00:00Z",
  • "numberOfPayments": 0,
  • "frequency": "one_week",
  • "bankAccount": "63eb772c27bfe15a04550cd6",
  • "initialPaymentAmount": "0.50",
  • "customerName": "string",
  • "customerEmail": "string",
  • "customerEmailCC": [
    ]
}

Response samples

Content type
application/json; charset=utf-8
{
  • "result": {
    }
}

Get recurring payments data

Get recurring payments data

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string

Recurring payment ID

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    }
}

Get list of all recurring payments

Get list of all recurring payments

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    }
}

Only draft and overdue recurring payment can be edited

Edit recurring payments

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string

Recurring payment ID

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Request Body schema: application/json
One of
reference
required
string <= 12 characters ^[a-z0-9-]+$
recurringAmount
required
string^[0-9]*.[0-9]{2}$

The amount of money that will come to your bank account from the client during the active period of regular payments

recurringPaymentDate
required
string

Javascript date. First payment date of recurring payment. Note: Due to banks requirements , the first payment date must be 3 working days in the future.

numberOfPayments
required
integer

Expected number of payments. Set 0 for indefinite

frequency
required
string
Enum: "one_week" "one_month" "three_months" "one_year"

Time interval between payments.

bankAccount
string

ID of the bank account to which the money will be sent

initialPaymentAmount
string^[0-9]*.[0-9]{2}$

Set if you want to request single immediate payment

customerName
string
customerEmail
string

Specify customer email address if you want to send payment request to the customer

customerEmailCC
Array of strings

Specify email CC addresses along with customer's email address if you want to send payment request to customer's CC

Responses

Request samples

Content type
application/json
Example
{
  • "reference": "12345abc",
  • "recurringAmount": "0.50",
  • "recurringPaymentDate": "2022-12-24T00:00:00Z",
  • "numberOfPayments": 0,
  • "frequency": "one_week",
  • "bankAccount": "63eb772c27bfe15a04550cd6",
  • "initialPaymentAmount": "0.50",
  • "customerName": "string",
  • "customerEmail": "string",
  • "customerEmailCC": [
    ]
}

Response samples

Content type
application/json; charset=utf-8
{
  • "saved": true,
  • "result": {
    }
}

Send recurring payment

Send recurring payment

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string

Recurring payment ID

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "saved": true,
  • "result": {
    }
}

Delete recurring payment

Delete recurring payment

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string

Recurring payment ID

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "deleted": true
}

Get list of all transactions of recurring payment

Get list of all transactions of recurring payment if exist.

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string

Recurring payment ID

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    ]
}

Transactions

This module will alow you to see details about transactions

Get list of all transaction

Get list of all transaction

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

query Parameters
filter
string
Example: filter=isSandbox

Filter by sandbox

filterValue
string
Example: filterValue=true
header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    }
}

Get single transaction

Get single transaction

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

id
required
string

Transaction ID

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": {
    }
}

Get completed transactions statistic

Get completed transactions statistic

path Parameters
companyId
required
string
Example: 63fd468f0137e28695d93b93

ID of company you're currently working with in a flow

query Parameters
dateFrom
string
Example: dateFrom=2023-04-09T00:00:00Z

Filter by completed date from

dateTo
string
Example: dateTo=2023-04-11T00:00:00Z

Filter by completed date to

isSandbox
string
Example: isSandbox=false

Filter by isSandbox value. Default: false

header Parameters
apisecret
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

API key generated by the partner at https://partner.fena.co/settings/api-keys.

Responses

Response samples

Content type
application/json; charset=utf-8
{
  • "data": [
    ]
}

Partner webhooks

If a webhook URL has been specified, then webhooks will be sent to the partner to this specified URL address. Webhook URL can be configured on the settings page https://partner.fena.co/settings/api-keys.

Bank account status update Webhook

The webhook is triggered either when the merchant made an attempt to connect their bank account using the Data API or the status of the bank account was changed by Fena. It does not matter how the bank account was connected, manually or using the Data API

Request Body schema: application/json

Webhook payload

event_name
required
string

Name of the webhook event

Value: "bank_account_status_update"
merchantId
required
string

ID of the merchant who owns the bank account

bankAccountId
required
string

ID of the bank account which status was updated

required
"verified" (string) or "pending" (string) or "disabled" (string) or "manual review required" (string) (BankAccountStatus)
connection_type
required
string
Enum: "data_api" "manual"

Type of connection

Responses

Request samples

Content type
application/json
{
  • "event_name": "bank_account_status_update",
  • "merchantId": "63630c54c07af6f56cbd959c",
  • "bankAccountId": "63630c54c07af6f56cbd959c",
  • "status": "verified",
  • "connection_type": "data_api"
}

Company verification status Webhook

The webhook is triggered when the director of the company completed ID verification or the company status was updated by Fena.

Request Body schema: application/json

Webhook payload

event_name
required
string

Name of the webhook event

Value: "company_verification_status_update"
merchantId
required
string

ID of the merchant who passed the verification

verifiedBy
string or null

ID of the director who verified the merchant

required
"active" (string) or "banned" (string) or "pending_verification" (string) or "started_verification" (string) or "rejected_with_retry_allowed" (string) (CompanyStatus)

Responses

Request samples

Content type
application/json
{
  • "event_name": "company_verification_status_update",
  • "merchantId": "63630c54c07af6f56cbd959c",
  • "verifiedBy": "63630c54c07af6f56cbd959c",
  • "status": "active"
}

Company officer verification status Webhook

Request Body schema: application/json

Webhook payload

event_name
required
string

Name of the webhook event

Value: "officer_verification_status_update"
merchantId
required
string

ID of the merchant

officerId
required
string

ID of the director who passed the verification

required
"active" (string) or "banned" (string) or "pending_verification" (string) or "started_verification" (string) or "rejected_with_retry_allowed" (string) (CompanyStatus)

Responses

Request samples

Content type
application/json
{
  • "event_name": "officer_verification_status_update",
  • "merchantId": "63630c54c07af6f56cbd959c",
  • "officerId": "63630c54c07af6f56cbd959c",
  • "status": "active"
}