Account

Object

Note:

  • Foule Factory API need basic authentication access, except POST /account function
  • In order to have this basic authentication access you need to user POST /account function.

 

Property Type Description
IdAccount Int Account identifier
ApiLogin String Api login
ApiPassphrase String Api passphrase. You only can get it on account creation (POST).
IdGender Int Gender Identifier
1 = Female
2 = Male
FirstName String First name
Name String Last name
Email String Email
Phone String Phone
Birthday DateTime Birthday
Company String Company name
Address1 String Address
Address2 String Address
City String City
PostalCode String Postal code
CountryCode String Country ISO code
Ex: French = FR
Country full list
BillAddress1 String Billing address
BillAddress2 String Billing address
BillCity String Billing city
BillPostalCode String Billing postal code
KYC Bool True = Official document are sent and validated
False = Official document are not sent and not validated
Nationality String Country ISO code
Ex: French = FR
Country full list
Optin Bool True = optin
False = not optin
Create

Method: POST

URL: /accounts

Return: GET /accounts + ApiPassphrase parameters

Note: You can get your ApiPassphrase parameters once when you create your account. You have to saveApiPassphrase because you cannot generate it a second time.

Parameters: (*Required parameters)

Property Type Description
IdGender* Int Gender Identifier
1 = Female
2 = Male
FirstName* String First name
Name* String Last name
Email* String Email
Phone* String Phone
Birthday* DateTime Birthday
Company String Company name
Address1* String Address
Address2 String Address
City* String City
PostalCode* String Postal code
CountryCode* String Country ISO code
Ex: French = FR
Country full list
BillAddress1 String Billing address
BillAddress2 String Billing address
BillCity String Billing city
BillPostalCode String Billing postal code
Nationality* String Country ISO code
Ex: French = FR
Country full list
Optin* Bool True = optin
False = not optin
Fetch

Method: GET

URL: /accounts

Parameters:

Property Type Description
IdAccount Int Account identifier
ApiLogin String Api login
IdGender Int Gender Identifier
1 = Female
2 = Male
FirstName String First name
Name String Last name
Email String Email
Phone String Phone
Birthday DateTime Birthday
Company String Company name
Address1 String Address
Address2 String Address
City String City
PostalCode String Postal code
CountryCode String Country ISO code
Ex: French = FR
Country full list
BillAddress1 String Billing address
BillAddress2 String Billing address
BillCity String Billing city
BillPostalCode String Billing postal code
KYC Bool True = Official document are sent and validated
False = Official document are not sent and not validated
Nationality String Country ISO code
Ex: French = FR
Country full list
Optin Bool True = optin
False = not optin

Account Wallet

Object

Note:

  • Amounts are in EURO
  • Amounts are in sens (base 100)

 

Property Type Description
AmountWithoutTax Int Amount in customer wallet. The amount is without tax. The amount is in sens (base 100). The amount is in EURO.
AmountTaxes Int Taxes amount. The amount is in sens (base 100). The amount is in EURO.
Fetch

Method: GET

URL: /accounts/wallet

Parameters:

Property Type Description
AmountWithoutTax Int Amount in customer wallet. The amount is without tax. The amount is in sens (base 100). The amount is in EURO.
AmountTaxes Int Taxes amount. The amount is in sens (base 100). The amount is in EURO.

Account Payin

Object

Note:

  • Amount is in EURO
  • Amount is in sens (base 100)
  • Amount is with taxes
  • Sandbox CB
Property Type Description
Amount Int Payin amount. Amount is in EURO. Amount is in sens (base 100). Amount is with taxes.
RedirectionURL String RedirectionURL is the URL address where you can pay by credit card.
ReturnUrl String  ReturnURL is the link where you will return after the payment. If you have no return URL in you web site set ‘http://www.foulefactory.com’
Create

Method: POST

URL: /accounts/payin

Note: Sandbox CB

Parameters: (*Required parameters)

Property Type Description
Amount* Int Payin amount. Amount is in EURO. Amount is in sens (base 100). Amount is with taxes.
ReturnUrl* String  ReturnURL is the link where you will return after the payment. If you have no return URL in you web site set ‘http://www.foulefactory.com’

 

Return:

Property Type Description
Amount Int Payin amount. Amount is in EURO. Amount is in sens (base 100). Amount is with taxes.
ReturnUrl String ReturnURL is the link where you will return after the payment. If you have no return URL in you web site set ‘http://www.foulefactory.com’
RedirectionURL String RedirectionURL is the URL address where you can pay by credit card.

Project

Object
Property Type Description
IdProject Int Project identifier
IdState Int Project state
IdTemplate Int IdTemplate is a template identifier. The template own form that Contributor will see. IdTemplate is given by Foule Factory.
IdType Int Project type
Tilte String Project title
EstimatedTimePerTask Time Time per task
Ex: ’00:03:30′ for 3 min and 30 sec
MaxEndDate DateTime End project date
NbTaskPerTaskLine Int
Number of contributor for each Task Line.
Ex: If you want that 2 contributor do 2 times each task, NbTaskPerTaskLine = 2.
AmountWithoutTaxPerTask Int Price per task without tax, in Centime. Earn directly by the fouleur. To find the final amount of your project, you need to add the 20% commission from us, plus the local tax.
UrlCsvFiles Array(UrlCsvFiles) List of UrlCsvFiles
TaskLines Array(TaskLines) List of TaskLines
AutomaticValidation Bool Are you using the automatic validation of tasksDefault False
NotificationUrl String Url called when Project State will change
Create

Method: POST

URL: /projects

Return: GET /projects

Parameters: (*Required parameters)

Property Type Description
IdTemplate* Int IdTemplate is a template identifier. The template own form that Contributor will see. IdTemplate is given by Foule Factory.
Tilte* String Project title
EstimatedTimePerTask* Time Time per task
Ex: ’00:03:30′ for 3 min and 30 sec
MaxEndDate* DateTime End project date
NbTaskPerTaskLine* Int Number of contributor for each Task Line.
Ex: If you want that 2 contributor do 2 times each task, NbTaskPerTaskLine = 2.
AmountWithoutTaxPerTask* Int Price per task without tax, in Centime
AutomaticValidation* Bool Are you using the automatic validation of tasks. Default False.
Fetch

Method: GET

URL: /projects/{IdProject}

Property Type Description
IdProject Int Project identifier
IdState Int Project state
IdTemplate Int IdTemplate is a template identifier. The template own form that Contributor will see. IdTemplate is given by Foule Factory.
IdType Int Project type
Tilte String Project title
EstimatedTimePerTask Time Time per task
Ex: ’00:03:30′ for 3 min and 30 sec
MaxEndDate DateTime End project date
NbTaskPerTaskLine Int
Number of contributor for each Task Line.
Ex: If you want that 2 contributor do 2 times each task, NbTaskPerTaskLine = 2.
AmountWithoutTaxPerTask Int Price per task without tax, without fee, in Centime
UrlCsvFiles Array(UrlCsvFiles) List of UrlCsvFiles
TaskLines Array(TaskLines) List of TaskLines
AutomaticValidation Bool Are you using the automatic validation of tasks
Default False
List

Method: GET

URL: /projects/

Property Type Description
Projects Array(Project) List of project

CSV File

Object
Property Type Description
IdCsvFile Int URL CSV file identifier
IdProject Int URL CSV file project identifier
URL String URL CSV file URL
Normalized Bool 0 = CSV file is not normalized yet
1 = CSV file is normalized
File String (base64) Only CSV format are accepted, transformed in base 64
Header Bool 0 = The first line is an header line
1 = There is no header line
Separator Char(5) URL SCV file separator column
Create

Method: POST

URL: /csvfiles

Return: GET /csvfiles

Parameters: (*Required parameters)

Property Type Description
IdProject* Int URL CSV file project identifier
File* String (base64) Only CSV format are accepted, transformed in base 64
Header* Bool 0 = The first line is an header line
1 = There is no header line
Separator* Char(5) URL SCV file separator column
Fetch

Method: GET

URL: /csvfiles/{IdCsvFile}

Property Type Description
IdCsvFile Int URL CSV file identifier
IdProject Int URL CSV file project identifier
URL String URL CSV file URL
Normalized Bool 0 = CSV file is not normalized yet
1 = CSV file is normalized
File String (base64) Only CSV format are accepted, transformed in base 64
Header Bool 0 = The first line is an header line
1 = There is no header line
Separator Char(5) URL SCV file separator column
List

Method: GET

URL: /projects/{IdProject}/urlCsvFiles

Parameters:

Property Type Description
CsvFiles Array(CsvFiles) List of CsvFiles

Project Task

List

Method: GET

URL: /projects/{IdProject}/tasks

Parameters:

Property Type Description
Tasks Array(Tasks) List of Tasks

Project Task Line

List

Method: GET

URL: /projects/{IdProject}/taskLines

Parameters:

Property Type Description
TaskLines Array(TaskLines) List of TaskLines

Task Line

Object
Property Type Description
IdTaskLine Int Task line identifier
IdProject Int Task line project identifier
TaskColumns Array(string) List of task columns
Tasks Array(int) List of tasks identifier
TaskLinesAnswer Array(string) List of answer
Fetch

Method: GET

URL: /taskLines/{IdTaskLine}

Property Type Description
IdTaskLine Int Task line identifier
IdProject Int Task line project identifier
TaskColumns Array(string) List of task columns
Tasks Array(int) List of tasks identifier
TaskLinesAnswer Array(string) List of answer

Task

Object

Note: Tasks are auto approve after 7 days

Property Type Description
IdTask Int Task identifier
IdTaskLine Int Task task line identifier
IdSupplier Int Task supplier identifier
IdTaskState Int Task state
IdTaskType Int Task type
UpdateDate DateTime Task update date
CreateDate DateTime Task create date
TaskAnswerText Array(TaskAnswerText) List of task answer text (text box question)
TaskAnswerChoice Array(TaskAnswerChoice) List of task answer choice (check box question, dropdown list question, radio button question)
TaskAnswer Array(string) List of answer (text box question, check box question, dropdown list question, radio button question)
Fetch

Method: GET

URL: /task/{IdTask}

Property Type Description
IdTask Int Task identifier
IdTaskLine Int Task task line identifier
IdSupplier Int Task supplier identifier
IdTaskState Int Task state
IdTaskType Int Task type
UpdateDate DateTime Task update date
CreateDate DateTime Task create date
TaskAnswer Array(string) List of task answer
Update

Method: PUT

URL: /task/

Note: Tasks are auto approve after 7 days

Property Type Description
IdTask Int Task identifier
State String
  • APPROVE
  • REJECT
List

Method: GET

URL: /taskLines/{IdTaskLine}/tasks

Property Type Description
Tasks Array(Tasks) List of tasks

Task Answer Choice

Object
Property Type Description
IdTaskAnswerChoice Int Task answer text identifier
Question String Task question
QuestionNotice String Task question notice
Require Bool 0 = an answer is require
1 = an answer is not require
Option Array(String) Question option
OptionAnswer Array(String) Question option answer
Fetch

Method: GET

URL: /TaskAnswerChoices/{IdTaskAnswerChoice}

Property Type Description
IdTaskAnswerChoice Int Task answer text identifier
Question String Task question
QuestionNotice String Task question notice
Require Bool 0 = an answer is require
1 = an answer is not require
Option Array(String) Question option
OptionAnswer Array(String) Question option answer
List

Method: GET

URL: Tasks/{IdTask}/TaskAnswerChoices

Property Type Description
TaskAnswerChoices Array(TaskAnswerChoice) List of task answer choice (check box question, dropdown list question, radio button question)

Task Answer Text

Object
Property Type Description
IdTaskAnswerText Int Task answer text identifier
Question String Task question
QuestionNotice String Task question notice
Require Bool 0 = an answer is require
1 = an answer is not require
Answer String Task answer
Fetch

Method: GET

URL: /TaskAnswerTexts/{IdTaskAnswerText}

Property Type Description
IdTaskAnswerText Int Task answer text identifier
Question String Task question
QuestionNotice String Task question notice
Require Bool 0 = an answer is require
1 = an answer is not require
Answer String Task answer
List

Method: GET

URL: Tasks/{IdTask}/TaskAnswerTexts

Property Type Description
TaskAnswerText Array(TaskAnswerText) List of task answer text (text box question)

Project Type

IdType Name
1 Traitement de données
2 Rédaction
3 Transcription
4 Phoning
5 Recherche
6 Panel
7 Autre

Project State

IdState Name
1 Create
2 Waiting Payment
7 Normalization
3 Online
6 Pending closure
4 Close
5 Deleted

Task Type

Name Value Description
Single 1 Single supplier per task
Working 2 Task not finished
Unanimity 3 Each supplier gave the same answer
MajorityValidated 4 A majority of supplier gave this answer
MajorityRefused 5 A majority of supplier didn’t give this answer
Done 6 Tagging done
Undefined 7 No supplier gave two times the same answer

Task State

Name Value Description
Create 1 Create but not validate by Foule Factory
Pending 2 Task is pending for work
Working 3 When a fouleur work on the task
Tagging 1005 Editing the task type
Done 4 Task is done
PaymentValidate 1002 Task validated and waiting for payment
Validate 5 Task validated and paied
PaymentReject 1003 Task rejected and waiting for refund
Reject 6 Task rejected and refund
ProjectCancel 1004 Task cancelled and waiting for refund
Cancel 1001 Task cancelled and refund

Date, Time and DateTime Format

Date

Default Date format is YYYY-MM-DD
Ex: 1982-12-24 for 24/12/1982

Time

Default Time format is HH:MM:SS
Ex: 06:45:30

DateTime

Default DateTime format is YYYY-MM-DDTHH:MM:SS
Ex: 1982-12-24T06:45:30 for 24/12/1982 at 06:45:30

Reference:
Standard date and time format

Country List

Code ISO English name French name
AF Afghanistan Afghanistan
AL Albania Albanie
AQ Antarctica Antarctique
DZ Algeria Algérie
AS American Samoa Samoa Américaines
AD Andorra Andorre
AO Angola Angola
AG Antigua and Barbuda Antigua-et-Barbuda
AZ Azerbaijan Azerbaïdjan
AR Argentina Argentine
AU Australia Australie
AT Austria Autriche
BS Bahamas Bahamas
BH Bahrain Bahreïn
BD Bangladesh Bangladesh
AM Armenia Arménie
BB Barbados Barbade
BE Belgium Belgique
BM Bermuda Bermudes
BT Bhutan Bhoutan
BO Bolivia Bolivie
BA Bosnia and Herzegovina Bosnie-Herzégovine
BW Botswana Botswana
BV Bouvet Island Île Bouvet
BR Brazil Brésil
BZ Belize Belize
IO British Indian Ocean Territory Territoire Britannique de l’Océan Indien
SB Solomon Islands Îles Salomon
VG British Virgin Islands Îles Vierges Britanniques
BN Brunei Darussalam Brunéi Darussalam
BG Bulgaria Bulgarie
MM Myanmar Myanmar
BI Burundi Burundi
BY Belarus Bélarus
KH Cambodia Cambodge
CM Cameroon Cameroun
CA Canada Canada
CV Cape Verde Cap-vert
KY Cayman Islands Îles Caïmanes
CF Central African République Centrafricaine
LK Sri Lanka Sri Lanka
TD Chad Tchad
CL Chile Chili
CN China Chine
TW Taiwan Taïwan
CX Christmas Island Île Christmas
CC Cocos (Keeling) Islands Îles Cocos (Keeling)
CO Colombia Colombie
KM Comoros Comores
YT Mayotte Mayotte
CG Republic of the Congo République du Congo
CD The Democratic Republic Of The Congo République Démocratique du Congo
CK Cook Islands Îles Cook
CR Costa Rica Costa Rica
HR Croatia Croatie
CU Cuba Cuba
CY Cyprus Chypre
CZ Czech Republic République Tchèque
BJ Benin Bénin
DK Denmark Danemark
DM Dominica Dominique
DO Dominican Republic République Dominicaine
EC Ecuador Équateur
SV El Salvador El Salvador
GQ Equatorial Guinea Guinée Équatoriale
ET Ethiopia Éthiopie
ER Eritrea Érythrée
EE Estonia Estonie
FO Faroe Islands Îles Féroé
FK Falkland Islands Îles (malvinas) Falkland
GS South Georgia and the South Sandwich Islands Géorgie du Sud et les Îles Sandwich du Sud
FJ Fiji Fidji
FI Finland Finlande
AX Åland Islands Îles Åland
FR France France
GF French Guiana Guyane Française
PF French Polynesia Polynésie Française
TF French Southern Territories Terres Australes Françaises
DJ Djibouti Djibouti
GA Gabon Gabon
GE Georgia Géorgie
GM Gambia Gambie
PS Occupied Palestinian Territory Territoire Palestinien Occupé
DE Germany Allemagne
GH Ghana Ghana
GI Gibraltar Gibraltar
KI Kiribati Kiribati
GR Greece Grèce
GL Greenland Groenland
GD Grenada Grenade
GP Guadeloupe Guadeloupe
GU Guam Guam
GT Guatemala Guatemala
GN Guinea Guinée
GY Guyana Guyana
HT Haiti Haïti
HM Heard Island and McDonald Islands Îles Heard et Mcdonald
VA Vatican City State Saint-Siège (état de la Cité du Vatican)
HN Honduras Honduras
HK Hong Kong Hong-Kong
HU Hungary Hongrie
IS Iceland Islande
IN India Inde
ID Indonesia Indonésie
IR Islamic Republic of Iran République Islamique d’Iran
IQ Iraq Iraq
IE Ireland Irlande
IL Israel Israël
IT Italy Italie
CI Côte d’Ivoire Côte d’Ivoire
JM Jamaica Jamaïque
JP Japan Japon
KZ Kazakhstan Kazakhstan
JO Jordan Jordanie
KE Kenya Kenya
KP Democratic People’s Republic of Korea République Populaire Démocratique de Corée
KR Republic of Korea République de Corée
KW Kuwait Koweït
KG Kyrgyzstan Kirghizistan
LA Lao People’s Democratic Republic République Démocratique Populaire Lao
LB Lebanon Liban
LS Lesotho Lesotho
LV Latvia Lettonie
LR Liberia Libéria
LY Libyan Arab Jamahiriya Jamahiriya Arabe Libyenne
LI Liechtenstein Liechtenstein
LT Lithuania Lituanie
LU Luxembourg Luxembourg
MO Macao Macao
MG Madagascar Madagascar
MW Malawi Malawi
MY Malaysia Malaisie
MV Maldives Maldives
ML Mali Mali
MT Malta Malte
MQ Martinique Martinique
MR Mauritania Mauritanie
MU Mauritius Maurice
MX Mexico Mexique
MC Monaco Monaco
MN Mongolia Mongolie
MD Republic of Moldova République de Moldova
MS Montserrat Montserrat
MA Morocco Maroc
MZ Mozambique Mozambique
OM Oman Oman
NA Namibia Namibie
NR Nauru Nauru
NP Nepal Népal
NL Netherlands Pays-Bas
AN Netherlands Antilles Antilles Néerlandaises
AW Aruba Aruba
NC New Caledonia Nouvelle-Calédonie
VU Vanuatu Vanuatu
NZ New Zealand Nouvelle-Zélande
NI Nicaragua Nicaragua
NE Niger Niger
NG Nigeria Nigéria
NU Niue Niué
NF Norfolk Island Île Norfolk
NO Norway Norvège
MP Northern Mariana Islands Îles Mariannes du Nord
UM United States Minor Outlying Islands Îles Mineures Éloignées des États-Unis
FM Federated States of Micronesia États Fédérés de Micronésie
MH Marshall Islands Îles Marshall
PW Palau Palaos
PK Pakistan Pakistan
PA Panama Panama
PG Papua New Guinea Papouasie-Nouvelle-Guinée
PY Paraguay Paraguay
PE Peru Pérou
PH Philippines Philippines
PN Pitcairn Pitcairn
PL Poland Pologne
PT Portugal Portugal
GW Guinea-Bissau Guinée-Bissau
TL Timor-Leste Timor-Leste
PR Puerto Rico Porto Rico
QA Qatar Qatar
RE Réunion Réunion
RO Romania Roumanie
RU Russian Federation Fédération de Russie
RW Rwanda Rwanda
SH Saint Helena Sainte-Hélène
KN Saint Kitts and Nevis Saint-Kitts-et-Nevis
AI Anguilla Anguilla
LC Saint Lucia Sainte-Lucie
PM Saint-Pierre and Miquelon Saint-Pierre-et-Miquelon
VC Saint Vincent and the Grenadines Saint-Vincent-et-les Grenadines
SM San Marino Saint-Marin
ST Sao Tome and Principe Sao Tomé-et-Principe
SA Saudi Arabia Arabie Saoudite
SN Senegal Sénégal
SC Seychelles Seychelles
SL Sierra Leone Sierra Leone
SG Singapore Singapour
SK Slovakia Slovaquie
VN Vietnam Viet Nam
SI Slovenia Slovénie
SO Somalia Somalie
ZA South Africa Afrique du Sud
ZW Zimbabwe Zimbabwe
ES Spain Espagne
EH Western Sahara Sahara Occidental
SD Sudan Soudan
SR Suriname Suriname
SJ Svalbard and Jan Mayen Svalbard etÎle Jan Mayen
SZ Swaziland Swaziland
SE Sweden Suède
CH Switzerland Suisse
SY Syrian Arab Republic République Arabe Syrienne
TJ Tajikistan Tadjikistan
TH Thailand Thaïlande
TG Togo Togo
TK Tokelau Tokelau
TO Tonga Tonga
TT Trinidad and Tobago Trinité-et-Tobago
AE United Arab Emirates Émirats Arabes Unis
TN Tunisia Tunisie
TR Turkey Turquie
TM Turkmenistan Turkménistan
TC Turks and Caicos Islands Îles Turks et Caïques
TV Tuvalu Tuvalu
UG Uganda Ouganda
UA Ukraine Ukraine
MK The Former Yugoslav Republic of Macedonia L’ex-République Yougoslave de Macédoine
EG Egypt Égypte
GB United Kingdom Royaume-Uni
IM Isle of Man Île de Man
TZ United Republic Of Tanzania République-Unie de Tanzanie
US United States États-Unis
VI U.S. Virgin Islands Îles Vierges des États-Unis
BF Burkina Faso Burkina Faso
UY Uruguay Uruguay
UZ Uzbekistan Ouzbékistan
VE Venezuela Venezuela
WF Wallis and Futuna Wallis et Futuna
WS Samoa Samoa
YE Yemen Yémen
CS Serbia and Montenegro Serbie-et-Monténégro
ZM Zambia Zambie

Base 64 Conversion Tools

URL: http://tools.foulefactory.com/base64

Sandbox Access

API access

URL: https://sandbox-api.foulefactory.com

 

Create an account

URL: https://sandbox-api.foulefactory.com/#!/Account/Account_CreateAccount

 

Carte bleu de test

Visa/MC

For payments under 100€ you can use these cards:

  • 4706750000000009
  • 4706750000000033
  • 4706750000000025
  • 4706750000000017

For payments with 3D Secure you can use these cards:

3D Secure starts from 100€. Therefore in the Sandbox environment, all payments over 100€ must be processed with one of the following cards:

  • 3569990000000132
  • 3569990000000157

You can only use these cards with the password ″secret3″ (is different from the BCMC and Diners one!). If you put a wrong password the card will be blocked

In order to test the liability shift, you can use these cards:

  • 4970100000000154
  • 4970101122334422
  • 4970101122334406
  • 4970101122334414

Maestro

All Maestro payments require 3DS

  • 3012340000000000
  • 3012349999999999

You can only use these cards with the password ″MAES123″ (this is different to the Visa/Mastercard and BCMC one!). If you put a wrong password the card will be blocked

more info: https://docs.mangopay.com/guide/testing-payments

Prod Access

API access

URL: https://api.foulefactory.com

Create an account

URL: https://api.foulefactory.com/#!/Account/Account_CreateAccount

HTTP Response

 

HTTP response status codes:

  • 200: request successful
  • 400: logical error
  • 401: access is forbidden
  • 404: object not found
  • 500: internal server error

Error Object:

Property Type Description
Message String Error message
ErrorId Guid Error id
Date DateTime Error date time
Type String Error type
Code String Error code
Errors Array(string) Description error list

Payment Errors

 

With the Visa/Mastercard credit cards, you can trigger specific error codes by using the transaction amounts given in the column « Test amount »

Operation failed

ResultCode ResultMessage More information Test amount
001999 Generic Operation error Mangopay has no information for the bank yet
001001 Unsufficient wallet balance The wallet balance doesn’t allow to process transaction
001002 Author is not the wallet owner The user ID used as Author has to be the wallet owner
001011 Transaction amount is higher than maximum permitted amount
001012 Transaction amount is lower than minimum permitted amount
001013 Invalid transaction amount 333.13
001014 CreditedFunds must be more than 0 (DebitedFunds can not equal Fees)

PayIn Web errors

ResultCode ResultMessage More information
001030 User has not been redirected The user never gets the payment page and never opens the Payline session
001031 User canceled the payment The User clicks on « Cancelled » on the payment page
101002 The transaction has been cancelled by the user The User clicks on « Cancelled » on the payment page
001032 User is filling in the payment card details The user is still on the payment page (Payline session)
001033 User has not been redirected then the payment session has expired The session has expired so the Payin Web is failed. The user has gone on the payment page
001034 User has let the payment session expire without paying The user went to the payment page but let the session expired. So the Payin Web has failed
101001 The user does not complete transaction

Refund transaction errors

ResultCode ResultMessage More information
001401 Transaction has already been successfully refunded
005403 The refund cannot exceed initial transaction amount
005404 The refunded fees cannot exceed initial fee amount
005405 Balance of client fee wallet insufficient
005407 Duplicated operation: you cannot refund the same amount more than once for a transaction during the same day

Card input errors

ResultCode ResultMessage More information Test amount
105101 Invalid card number 333.14
105102 Invalid cardholder name The card holder name given doesn’t match the real owner of the card
105103 Invalid PIN code 333.55
105104 Invalid PIN format

Transaction Refused

ResultCode ResultMessage More information Test amount
101101 Transaction refused by the bank (Do not honor) The error « Do not honor » is a message from the bank. You could get it for several raisons: Maximum amount spent per month has been reached on this card // Maximum amount spent on internet per month has been reached on this card // No more funds on bank account 333.05
101102 Transaction refused by the bank (Amount limit) You will get this error if the user reached a bank amount limit. It could be: Maximum pre authorized amount reached // Maximum amount spent per month has been reached on this card // Maximum amount spent on internet per month has been reached on this card 333.51
101103 Transaction refused by the terminal 333.58
101104 Transaction refused by the bank (card limit reached) 333.60
101105 The card has expired
101106 The card is inactive The card is not active accourding to the bank and can therefore not be used
101410 The card is not active The card has not been disabled on Mangopay and is no longer useable
101111 Maximum number of attempts reached Too much attempts for the same transaction 333.38
101112 Maximum amount exceeded This is a card limitation on spent amount
101113 Maximum Uses Exceeded Maximum attempts with this cards reached. You must try again after 24 hours
101115 Debit limit exceeded This is a card limitation on spent amount 333.61
101116 Amount limit The contribution transaction has failed
101199 Transaction refused The transaction has been refused by the bank. Contact your bank in order to have more information about it

Secure mode / 3DSecure errors

ResultCode ResultMessage More information
101399 Secure mode: 3DSecure authentication is not available
101304 Secure mode: The 3DSecure authentication session has expired
101303 Secure mode: The card is not compatible with 3DSecure
101302 Secure mode: The card is not enrolled with 3DSecure
101301 Secure mode: 3DSecure authentication has failed

Tokenization / Card registration errors

ResultCode ResultMessage More information
001599 Token processing error The token has not been created as there was a problem – check that you sent all the correct parameters.
105299 Token input Error This is a generic error meaning that we got an error when submitting the token to the bank. It is usually returned because there was a too long time between the card registration request and the first action done with this card. Indeed, you have 20min maximum to create the first Pre-auth or Payin
105202 Card number: invalid format This error is returned in case the card number formate is wrong (on card registration)
105203 Expiry date: missing or invalid format This error is returned in case the expiry date is wrong (on card registration)
105204 CVV: missing or invalid format This error is returned in case the CVV is wrong (on card registration)
105205 Callback URL: Invalid format This error is returned in case the ReturnURL is wrong on CardRegistration process
105206 Registration data : Invalid format This error is returned in case the data sent to the tokenization server is not the right. You can get this error when you are trying to edit the CardRegistration Object with the RegistrationData(got from the tokenization server)

The following errors may be received by our PSP when POSTing the card data to the CardRegistrationURL

ResultCode ResultMessage More information Test amount
02625 Invalid card number
02626 Invalid date. Use mmdd format
02627 Invalid CCV number
02628 Transaction refused Invalid URL return field
02101 Internal Error There is an issue on the tokenization server (PSP side). Please check the resolution on http://status.mangopay.com/
02632 Method GET is not allowed Your Payment form has to use POST method on Tokenization Server
09101 Username/Password is incorrect
09102 Account is locked or inactive
01902 This card is not active 333.12
02624 Card expired 333.33
09104 Client certificate is disabled
09201 You do not have permissions to make this API call
02631 Delay exceeded Too much time taken from the creation of the CardRegistration object to the submission of the Card Details on the Tokenizer Server

more info: https://docs.mangopay.com/guide/errors