About PFConnect

General information about PFConnect

Logo

Documentation > PFConnect > image-2024-2-2_9-27-18.png

Info

PFConnect offers online credit solution for French consumers.

With this means of payment, merchants provide the financing capability for major purchases to their customers, who after redirection to PFConnect webpages can further pay by installments ranging between 4-48 installments and order amount ranging between €150 to €16,000.
After credit validation the merchant will be paid upfront for the total basket amount, consumers can purchase directly online on the merchant online stores supporting this payment method, proceeding the necessary step including e-signature on the PFConnect credit application form. The approval will be instant.

Type

Payments by Invoice and Installments

Process flow chart

PFConnect process flow

interface

Calculate quotations with PFConnect via form interface

Prior to redirection (before initiating the Authorization operation through PFconnect.aspx) it is imperative to employ simulations/quotations. This step ensures that customers are provided with options for financial products and simulations on your pages/apps. Utilize this form to query financial products and perform quotation calculations, obtaining a list of available financial products for financing purposes.

To calculate quotations for financing options with PFConnect, please use the following URL:

PFQuotation.aspx

Key

Format

CND

Description

RefNr

an..13

C

Supplementary transaction identifier. Only the following characters are allowed:

Alphabetical letters [A-Za-z] (from A to Z lower or upper case)
Numbers [0-9] (from 0 to 9)

Notice: If RefNr is not present, TransID will be used instead. Therefore in such case TransID should meet format and length of RefNr.

Key	Format	CND	Description
CountryCode	a2	O	Country, where merchant operates. Possible values: FR, IT, ES
ProductID	n..10	M	Financial product identifier
TimeUnit	ans..10	M	Time unit for the duration, defines the time between two installments. possible values: QUARTER, BIMONTH, MONTH, BIWEEK, WEEK
InstallmentNumber	n..10	O	Duration of the credit by credit time unit
XID	an30	O	ID of financed element
ShoppingBasketAmount	n..10	C	Mandatory only if also DownPaymentAmount is valorized (and viceversa)
DownPaymentAmount	n..10	C	Mandatory only if also ShoppingBasketAmount field is valorized (and viceversa)
DeliveryDate	dttm	C	Delivery date, estimated by the merchant. Mandatory if merchant operates in France.
Articlelist	string	C	Base64 encoded value. Mandatory if merchant operates in Italy.
itemtypes	array	C	Array of items, e.g.: {"items": [{items1 ...}{item2...}]}
itemtypes.id	ans..30	C	ID will be assigned by merchant for the purchased good
itemtypes.name	ans..30	C	Name of the purchased goods, assigned by merchant
itemtypes.description	ans..30	O	Description for purchased goods, assigned by merchant

Parameters for calculate quotation with PFConnect

Articlelist

Articlelist should be sent as a base64-encoded value. Please find the example below.

"itemTypes": [ 
{ 
"id": "273",
"name": "Biclycle", 
"description": "Biclycle" 
} 
]

Articlelist=Iml0ZW1UeXBlcyI6IFsgCnsgCiJpZCI6ICIyNzMiLAoibmFtZSI6ICJCaWNseWNsZSIsIAoiZGVzY3JpcHRpb24iOiAiQmljbHljbGUiIAp9IApd

Key

Format

CND

Description

RefNr

an..13

C

Supplementary transaction identifier. Only the following characters are allowed:

Alphabetical letters [A-Za-z] (from A to Z lower or upper case)
Numbers [0-9] (from 0 to 9)

Notice: If RefNr is not present, TransID will be used instead. Therefore in such case TransID should meet format and length of RefNr.

Key

Format

CND

Description

Financing

ans..1024

M

FinancingScenarioDetail – A set of quotations (simulations variations) calculated for a Financeable and FinancialProduct pair.

Contains financial product data for a previous initialization. They are returned in JSON format and Base64 encoded.

Return parameters for calculate quotation with PFConnect

Create PFConnect authorisation

To create an authorisation with PFConnect, please use the following URL:

PFConnect.aspx

Notice: Please keep in mind that a session expires within 30 minutes. An iFrame integration is not recommended.

Key

Format

CND

Description

PayID

an32

M

Unique payment reference ID returned in the quotation response. It must be included in the authorisation request to link the calculated quotation with the Financial Journey of the customer.

RefNr

an..13

C

Supplementary transaction identifier. Only the following characters are allowed:

Alphabetical letters [A-Za-z] (from A to Z lower or upper case)
Numbers [0-9] (from 0 to 9)

Notice: If RefNr is not present, TransID will be used instead. Therefore in such case TransID should meet format and length of RefNr.

Key	Format	CND	Description
StoreName	ans..50	C	Merchant identifier assigned by PF. Mandatory for the merchants, which operates in Spain and Italy.
AboID	ns..30	C	SubscriptionID on PSP side will be used by axepta to identfy its merchant. Mandatory for the merchants, which operates in France.
Date	dttm	C	Date of the application for financing. Mandatory for merchants operating in France and optional for those operating in Spain.
			Customer information
FirstName	ans..23	C	First name of the customer Mandatory for merchants operating in France and optional for those operating in Spain.
LastName	ans..23	C	Last name of the customer Mandatory for merchants operating in France and optional for those operating in Spain.
DateOfBirth	ns10	O	Date of birth in the format YYYY-MM-DD
NatIdentNr	ans..20	O	National identification
Phone	a8..15	O	Phone number (fixed network)
MobileNr	a8..15	C	Phone number (mobile) Mandatory for merchants operating in France and optional for those operating in Spain.
Email	ans..49	C	E-Mail-Address of the customer Mandatory for merchants operating in France and optional for those operating in Spain.
Role	ans..10	M	Identifier role of the customer, Possible values: OWNER, THIRD, CUSTOMER
			Billing address
bdAddressAddition	ans..60	C	Additional/complementary address line. Special character [;] not allowed. Mandatory for merchants operating in France and optional for those operating in Spain.
bdZIP	ans..10	C	Postal code in the invoicing address Mandatory for merchants operating in France and optional for those operating in Spain.
bdCity	ans..40	C	Town/city in the invoicing address Mandatory for merchants operating in France and optional for those operating in Spain.
bdCountryCode	a2	C	Country code of invoicing address according to ISO-3166-1, alphanumeric 2 chars Mandatory for merchants operating in France and optional for those operating in Spain.
			Shipping address
sdAddressAddition	ans..60	C	Address information in the delivery address Mandatory for merchants operating in France and optional for those operating in Spain.
sdZip	ans..10	C	Postcode in the delivery address Mandatory for merchants operating in France and optional for those operating in Spain.
sdCity	ans..40	C	Town/city in the delivery address Mandatory for merchants operating in France and optional for those operating in Spain.
sdCountryCode	a2	C	Country code of delivery address according to ISO-3166-1, alphanumeric 2 chars Mandatory for merchants operating in France and optional for those operating in Spain.
			Custom properties
CustomValue	ans..60	O	Value of the customProperties MerchantData
			To be financed elements
XID	an30	C	Identification of the order bag to be financed. Mandatory for merchants operating in Spain and Italy.
ShoppingBasketAmount	n..10	C	The total price amount of the orderBag Mandatory for merchants operating in Spain.
DeliveryDate	dttm	O	Delivery date, estimated by the merchant
Articlelist	string	C	Base64 encoded value. Mandatory if merchant operates in Italy.
itemtypes	array	C	Array of items, e.g.: {"items": [{items1 ...}{item2...}]}
itemtypes.id	ans..30	C	ID will be assigned by merchant for the purchased good
itemtypes.name	ans..30	C	Name of the purchased goods, assigned by merchant
itemtypes.description	ans..30	O	Description for Purchased goods, assigned by merchant
			Financing criteria
ProgramID		O	Financial programID
PlanID		C	ID of the quotation (value transmitted on the response of the CalculateQuotation). Mandatory for merchants operating in France.
InstallmentNumber		C	In this field the partner can include the duration of the loan if they know it (eg: 6, 12, 18, 24, 36, 48 or 60). This field may also come empty. If it is empty, the longest duration will be shown to the user by default, and they will be able to play with the monthly payments, so that we will finally use the promotion that best suits the user's selection. Mandatory for merchants operating in France.
ProductID	n..10	M	Financial Product identifier

Parameters for payments with PFConnect

Key

Format

CND

Description

RefNr

an..13

C

Supplementary transaction identifier. Only the following characters are allowed:

Alphabetical letters [A-Za-z] (from A to Z lower or upper case)
Numbers [0-9] (from 0 to 9)

Notice: If RefNr is not present, TransID will be used instead. Therefore in such case TransID should meet format and length of RefNr.

Key	Format	CND	Description
CodeExt	ans..256	O	External error code
ErrorText	ans..256	O	Description of external error code
ApplicationID	ans..32	O	PF Identifier

Return parameters for URLSuccess, URLFailure or URLNotify with PFConnect

Capture

Captures are possible via a Server-to-Server connection. With this call you can process only full captures, a partial capture ist not possible. In order to perform a capture for PFConnect via a Server-to-Server connection, please use the following URL:

capture.aspx

Parameters for captures with PFConnect

Response parameters for captures of PFConnect

Credit with reference

credit.aspx

Parameters for credit payments with PFConnect

Response parameters for credit payments with PFConnect

Reversal

Reversals are possible via a Server-to-Server connection. If a Capture is still not done, with this call you can reverse the complete authorisation. In order to reverse a transaction with PFConnect, please use the following URL:

reverse.aspx

Parameters for reversals of PFConnect payments

Response parameters for reversals of PFConnect payments