Transfer

Introducing

This object enables money transfers from an FPay wallet to another FPay wallet or to a FPay wallet or to a mobile money account. When initiated, a Transfer immediately triggers a transfer from the Wallet indicated as the source to a mobile money account for the specified amount.
Any instance of this object passes through several states, which can be tracked by observing the status field: At the beginning it will be Starting, and at the end, the state will be either Successful or Failure.
Once the transfer is complete, a Transaction object will be created to materialize the money outflow from the FPay wallet. The title of this Transaction object can be controlled from the Transfer object by specifying the h1. field. If you omit this field, a default title will be added when the Transaction object is created, visible by accessing the h1 field of the Transaction object.

Operations

`get`

Returns an object Transfer found by an identifier.
You can use a unique ID specific to your system. To use your own ID instead of the one generated by FPay, you need to specify the foreignId field when creating the object. This will enable you to retrieve the object via the foreignId field, which must be unique for all Transfer objects. Here are all the fields whose values can be used as identifiers for this operation:

id
foreignId
attempt.id

const transferPromise = fPay.transfer.get("identifier");

`initiate`

Initiate a new Transfer operation and return the newly created instance.
This operation takes the following parameters as input:

InitiateTransferForm

amount Required

AmountForm
Operation amount without fees. If you pay the fees, your wallet will be debited for this amount plus fees. If your correspondent pays the fees, your wallet will be debited for exactly this amount.

currency Required: string
The only possible value is"XOF"

value Required: string
Numeric value of amount always positive or zero.

destination Required

DestinationForm
Destination of funds.

DestinationForm.MultipleDestinationForm
MultipleDestinationForm

DestinationForm.SingleDestinationForm
SingleDestinationForm

account Required

MoneyAccountForm
FPay Wallet OR Mobile money account to which you would like to you would like to send money. You can only transfer money to the wallets you own.

country Required: string
The only possible value is"CI"

identifier Required: string
FPay Wallet id identifier OR
Telephone number in international "+2250500000000"

providerKey Required: string
The only possible values are"FPay" "MoovMoney" "MtnMoney" "OrangeMoney"

description: string | undefined
Details, explanations and notes about this item to help you get organized and find your way around later.

fees

FeesForm | undefined

payer Required: string
Who pays the fees associated with this operation ? If no costs are involved, this value will be omitted.
The only possible values are"CounterPart" "Me" "Receiver" "Sender"

foreignData: string | undefined
Your own data that you can attach to the object you've created. This can be JSON XML other data formats or simply Strings.
The maximum allowed length is 128 characters.

foreignId: string | undefined
ID Personalisé ou bien ID de votre système interne que vous souhaitez attacher à cet objet pour vous permettre de le récupérer plus tard.
Once created, this value cannot be modified.
This value must be unique for each type.
The maximum allowed length is 128 characters.

h1

H1DescriptorForm | undefined
Title of this object, which will be displayed to the user if necessary, and which will become the h1 field of the Transaction object when it will be created.

en: string | undefined

fr: string | undefined

source

SourceForm | undefined
Source of funds.

SourceForm.MultipleSourceForm
MultipleSourceForm

SourceForm.SingleSourceForm
SingleSourceForm

account Required

MoneyAccountForm
Source of funds, FPay Wallet from which you would like to take money for this send. If no value is specified, your main wallet will be debited.

country Required: string
The only possible value is"CI"

identifier Required: string
FPay Wallet id identifier

providerKey Required: string
The only possible value is"FPay"

Here's an example of code for initiate a Transfer object:

const transferPromise = 
    fPay.transfer.initiate({
        amount: {
            currency: "XOF",
            value: "10_000"
        },
        destination: {
            _type: "Single",
            account: {
                country: "CI",
                identifier: "+2250700000000",
                providerKey: "OrangeMoney"
            }
        },
        description: "My description",
        fees: {
            payer: "CounterPart"
        },
        foreignData: "{\"myKey\": 19, \"myOtherKey\": \"myOtherValue\"}",
        foreignId: "123456789",
        h1: {
            en: "Payment description",
            fr: "Description du paiement"
        },
        source: {
            _type: "Single",
            account: {
                country: "CI",
                identifier: "123456789",
                providerKey: "FPay"
            }
        }
    });

`list`

Returns a collection of Transfer objects, possibly filtered and/or sorted. Here are the parameters supported by this operation.

NAME	TYPE	DESCRIPTION	DEFAULT VALUE
`filter`	string \| undefined	Condition to be met by any object returned in this collection	`undefined`
`sortBy`	string \| undefined	Specify the field and the order (ascending or descending) by which returned objects will be sorted	`createdTime:DESC`
`limit`	number \| undefined	Total number of results to return in this collection	`50`

Here are a few examples of code to execute a listing to return a collection of Transfer objects:

const transfersCollectionPromise = fPay.transfer.listAll();

const transfersCollectionPromise = 
    fPay.transfer.list({
        sortBy: "id:ASC"
    });

const transfersCollectionPromise = 
    fPay.transfer.list({
        limit: 5
    });

const transfersCollectionPromise = 
    fPay.transfer.list({
        filter: "id in {'31234', '5678', '9990'}"
    });

const transfersCollectionPromise = 
    fPay.transfer.list({
        filter: "createdTime isBefore Yesterday",
        sortBy: "foreignId:DESC"
    });

const transfersCollectionPromise = 
    fPay.transfer.list({
        filter: "id startsWith abcd",
        sortBy: "createdTime:ASC",
        limit: 25
    });

`fetchPage`

When you fetch a list of Transfer, the results returned by the server can be paginated, i.e. they will be arranged on several pages. This fetchPage function allows you to navigate from page to page, iterating over all the elements. Consequently, this function returns a collection of Transfer.

Let's say you've retrieved a collection of Transfer with the following code:

const transfersCollectionPromise = fPay.transfer.listAll();

If the result is spread over several pages, to go to the next page, you should do:

transfersCollectionPromise.then(transferCollection => {
    if(transferCollection.hasNextPage()) {
        const nextTransferPromise = fPay.transfer.fetchPage(transferCollection.pagination.nextPage);
    }
});

`update`

Modify a Transfer object and return the modified version.
Here are all the fields whose values can be used as identifiers for this operation:

id
foreignId
attempt.id

Modifying an object means modifying its modifiable fields. Modifiable fields can be either updated or deleted. Here's the list of modifiable fields for all Transfer objects:

NAME	TYPE	DESCRIPTION
`description`	string \| undefined	Can be updated Can be Deleted
`foreignData`	string \| undefined	Can be updated Can be Deleted

Here are a few examples of code to execute an update:

transferPromise = 
    fPay.transfer.update({
         id: "<id | foreignId>",
         change: {
            description: "<new value>",
            foreignData: "<new value>"
         }
    });

transferPromise = 
    fPay.transfer.update({
         id: "<id | foreignId>",
         change: {
            description: "<new value>"
         },
         'remove': ['foreignData']
    });

transferPromise = 
    fPay.transfer.update({
         id: "<id | foreignId>",
         'remove': ['description', 'foreignData']
    });

List Filter & Sort

Fields

When you retrieve a list, here are the fields you can use for filtering and sorting. as well as sorting.

NAME	TYPE	DESCRIPTION
`amount.currency.code`	string
`amount.value`	number
`attempt.id`	string
`completedTime`	string
`completedTime.iso8601`	string
`completedTime.timestamp.milliseconds`	number
`completedTime.timestamp.seconds`	number
`createdTime`	string
`createdTime.iso8601`	string
`createdTime.timestamp.milliseconds`	number
`createdTime.timestamp.seconds`	number
`creator`	string
`creator._type`	string
`creator.accountId`	string
`creator.authAccessId`	string
`creator.personId`	string
`description`	string
`destination`	string
`destination._type`	string
`destination.account.balanceType`	string
`destination.account.identifier._type`	string
`destination.account.identifier.value`	string
`destination.account.provider.country.iso3166.alpha2`	string
`destination.account.provider.country.iso3166.alpha3`	string
`destination.account.provider.country.name`	string
`destination.account.provider.key`	string
`destination.account.provider.name`	string
`destination.amount.currency.code`	string
`destination.amount.value`	number
`fees.amount.currency.code`	string
`fees.amount.value`	number
`fees.payer`	string
`fees.value.fixe`	number
`fees.value.percent`	number
`foreignId`	string
`h1Descriptor.en`	string
`h1Descriptor.fr`	string
`id`	string
`sending`	string
`source`	string
`source._type`	string
`source.account.balanceType`	string
`source.account.identifier._type`	string
`source.account.identifier.value`	string
`source.account.provider.country.iso3166.alpha2`	string
`source.account.provider.country.iso3166.alpha3`	string
`source.account.provider.country.name`	string
`source.account.provider.key`	string
`source.account.provider.name`	string
`source.amount.currency.code`	string
`source.amount.value`	number
`status`	string
`status._type`	string
`status.cancelled.afterTimeout`	boolean
`status.reason.en`	string
`status.reason.fr`	string

Code examples

Code examples are available on the Audit & Dashboard page

Fields

Transfer

amount

Amount

currency

AmountCurrency

code: string
The only possible value is"XOF"

unit: string
Symbol used to represent this currency. For now, the only value is "₣".

value: number
Numeric value of amount always positive or zero.

attempt

LightAttempt

id: string
Unique, unchangeable identifier made up of numbers and letters.

completedTime

UTCDateTime | undefined
If this value is present, then it corresponds to the date and time at which this operation ended. If it is absent, then this operation is still in progress.
Value always stored in UTC (Universal Time), this field contains a representation of this instant in ISO 8601 format, as well as a representation of this same instant in timestamp seconds and milliseconds.

iso8601: string
Date and time in ISO 8601 format

timestamp

Timestamp

milliseconds: number
Date and time in timestamp milli seconds

seconds: Double
Date and time in timestamp seconds

createdTime

UTCDateTime
Date and time at which this object was created. Value always stored in UTC (Universal Time), this field contains a representation of this instant in ISO 8601 format, as well as a representation of this same instant in timestamp seconds and milliseconds.

iso8601: string
Date and time in ISO 8601 format

timestamp

Timestamp

milliseconds: number
Date and time in timestamp milli seconds

seconds: Double
Date and time in timestamp seconds

creator

Creator

Creator.Api
Api

_type: string
The only possible value is"Api"

accountId: string

authAccessId: string

Creator.Ui
Ui

_type: string
The only possible value is"Ui"

accountId: string

personId: string

description: string | undefined
Details, explanations and notes about this item to help you get organized and find your way around later.

destination

Destination

Destination.Multiple
Multiple

_type: string
The only possible value is"Multiple"

Destination.Single
Single

_type: string
The only possible value is"Single"

account

MoneyAccount

balanceType: string
Indicates the type of balance used.
"AvailableBalance" literally means “Available Balance”. So, if the value of this field is “AvailableBalance”, then the funds are on the "AvailableBalance" and can be used. In some cases, funds are “Locked” (either on the "LockedInBalance" or "LockedOutBalance" ) and cannot be used until they are made available on the "AvailableBalance".
The only possible values are"AvailableBalance" "LockedInBalance" "LockedOutBalance"

identifier

MoneyAccountIdentifier

_type: string
Indicates the type of account on which “MoneyAccount” money is held. If it's a bank account, this field will have the value "Iban".
If it's a mobile money account, this field will have the value "MobileMoney".
If it's an FPay wallet, the value can be either "Id" or "Man", the latter meaning "Money Account Number".
The only possible values are"Iban" "Id" "Man" "MobileNumber"

value: string
Indicates the type of account on which “MoneyAccount” money is held. If it's a bank account, this field will have the value "Iban".
If it's a mobile money account, this field will have the value "MobileMoney".
If it's an FPay account, the value can be either "Id" or "Man", the latter meaning "Money Account Number".

provider

MoneyAccountProvider

country

Country

iso3166

Iso3166Country

alpha2: string
ISO 3166 code with 2 characters representing the country.
Example: “CI” for Côte d'Ivoire, “BF” for Burkina Faso and “SN” for Senegal.

alpha3: string
ISO 3166 code with 3 characters representing the country.
Example: “CIV” for Côte d'Ivoire, “BFA” for Burkina Faso and “SEN” for Senegal.

name: string
Country name in either English or French, depending on the language of your FPay account. If, when you registered, you chose French as the language of your account, then the country name will be in French. in French and if you have chosen English, then this name will be in English.

key: string
Key uniquely identifying the money account provider.
The only possible values are"FPay" "MoovMoney" "MtnMoney" "OrangeMoney"

name: string
Money account provider name

amount

Amount

currency

AmountCurrency

code: string
The only possible value is"XOF"

unit: string
Symbol used to represent this currency. For now, the only value is "₣".

value: number
Numeric value of amount always positive or zero.

fees

Fees

amount

Amount

currency

AmountCurrency

code: string
The only possible value is"XOF"

unit: string
Symbol used to represent this currency. For now, the only value is "₣".

value: number
Numeric value of amount always positive or zero.

payer: string | undefined
Who pays the fees associated with this operation ? If no costs are involved, this value will be omitted.
The only possible values are"Receiver" "Sender"

value

FeesValue

fixe: number
Fixed part of the fee amount. If the formula for calculating the fee is 1.5% + ₣150, then this field will have the value 150

percent: number
Variable part of the fee amount between 0 and 100. If the formula for calculating the fee is 1,5% + ₣150, then this field will have a value of 1,5.

foreignData: string | undefined
Your own data that you can attach to the object you've created. This can be JSON XML other data formats or simply Strings.
The maximum allowed length is 128 characters.

foreignId: string | undefined
ID Personalisé ou bien ID de votre système interne que vous souhaitez attacher à cet objet pour vous permettre de le récupérer plus tard.
Once created, this value cannot be modified.
This value must be unique for each type.
The maximum allowed length is 128 characters.

h1Descriptor

H1Descriptor | undefined

en: string | undefined

fr: string | undefined

id: string
Unique, unchangeable identifier made up of numbers and letters.

sending: string
The only possible values are"NotYetDone" "PartiallyDone" "TotallyDone"

source

Source

Source.Multiple
Multiple

_type: string
The only possible value is"Multiple"

Source.Single
Single

_type: string
The only possible value is"Single"

account

MoneyAccount

balanceType: string
Indicates the type of balance used.
"AvailableBalance" literally means “Available Balance”. So, if the value of this field is “AvailableBalance”, then the funds are on the "AvailableBalance" and can be used. In some cases, funds are “Locked” (either on the "LockedInBalance" or "LockedOutBalance" ) and cannot be used until they are made available on the "AvailableBalance".
The only possible values are"AvailableBalance" "LockedInBalance" "LockedOutBalance"

identifier

MoneyAccountIdentifier

_type: string
Indicates the type of account on which “MoneyAccount” money is held. If it's a bank account, this field will have the value "Iban".
If it's a mobile money account, this field will have the value "MobileMoney".
If it's an FPay wallet, the value can be either "Id" or "Man", the latter meaning "Money Account Number".
The only possible values are"Iban" "Id" "Man" "MobileNumber"

value: string
Indicates the type of account on which “MoneyAccount” money is held. If it's a bank account, this field will have the value "Iban".
If it's a mobile money account, this field will have the value "MobileMoney".
If it's an FPay account, the value can be either "Id" or "Man", the latter meaning "Money Account Number".

provider

MoneyAccountProvider

country

Country

iso3166

Iso3166Country

alpha2: string
ISO 3166 code with 2 characters representing the country.
Example: “CI” for Côte d'Ivoire, “BF” for Burkina Faso and “SN” for Senegal.

alpha3: string
ISO 3166 code with 3 characters representing the country.
Example: “CIV” for Côte d'Ivoire, “BFA” for Burkina Faso and “SEN” for Senegal.

name: string
Country name in either English or French, depending on the language of your FPay account. If, when you registered, you chose French as the language of your account, then the country name will be in French. in French and if you have chosen English, then this name will be in English.

key: string
Key uniquely identifying the money account provider.
The only possible values are"FPay" "MoovMoney" "MtnMoney" "OrangeMoney"

name: string
Money account provider name

amount

Amount

currency

AmountCurrency

code: string
The only possible value is"XOF"

unit: string
Symbol used to represent this currency. For now, the only value is "₣".

value: number
Numeric value of amount always positive or zero.

status

TransferStatus

TransferStatus.Completing
Completing

_type: string
The only possible value is"Completing"

TransferStatus.Failure
Failure

_type: string
The only possible value is"Failure"

cancelled

Cancelled | undefined

afterTimeout: boolean

reason

LocalizedText

en: string

fr: string

TransferStatus.Processing
Processing

_type: string
The only possible value is"Processing"

reason

LocalizedText

en: string

fr: string

TransferStatus.Started
Started

_type: string
The only possible value is"Started"

TransferStatus.Starting
Starting

_type: string
The only possible value is"Starting"

TransferStatus.Successful
Successful

_type: string
The only possible value is"Successful"

TransferStatus.WaitingToStart
WaitingToStart

_type: string
The only possible value is"WaitingToStart"

url: string
URL on which a properly authorized GET method will return the instance of the object on which this field is defined.